NdisMapFile

VOID NdisMapFile( OUT PNDIS_STATUS Status, OUT PVOID *MappedBuffer, IN NDIS_HANDLE FileHandle );

NdisMapFile함수는 만약 파일이 현재 맵되지않았다면, 이미 열려진 파일을 호출자가 접근할수있는 버퍼를 맵한다.

매개변수

Status

이 함수가 맵핑하는 연산의 상태를 리턴하는 호출자 제공 변수의 포인터, 이것은 다음중 하나일수 있다.:

NDIS_STATUS_SUCCESS

호출자는 NdisUnmapFile함수가 호출될때까지 파일 내용들에대한 접근을 배재한다.

NDIS_STATUS_ALREADY_MAPPED

호출자는 이시기에 파일내용들에접근을 할수 없다.

MappedBuffer

이함수가 멥된 파일 내용들의 베이스 가상주소를 리턴하거나 혹은 NULL을 리턴하는 호출자 제공 변수의 포인터.

FileHandle

NdisOpenFile함수의 선행 호출에의해 리턴된 핸들을 지정한다.

주석

NdisMapFile함수는 열려진 파일로 가상 주소 범위를 연관지어(멥하여) 드라이버는 파일 내용에 접근할수 있다. NdisMapFile함수는 언제든 두드러지는 특별한 파일의 단 하나의 멥핑을 허용한다. 결과적으로, 성공적인 호출자는 NdisUnmapFile 혹은 NdisCloseFile함수가 호출될때까지 파일 데이타에 배타적인 접근이 주어진다.

닉 드라이버는 필요에따라 그런 열려진 파일을 UN멥할수 있다. NdisMapFile혹은 NdisUnmapFile함수의 교대 호출을 이용하여. NdisCloseFile함수의 호출은 FileHandle을 해제하고 파일 내용들을 포함하는 버퍼를 할당해제한다.

닉 드라이버는 초기화동안에만 NdisMapFile함수를 호출할수 있다.

NdisMapFile함수의 호출은 IRQL <= DISPATCH_LEVEL에서 동작한다.