NdisOpenFile
VOID
NdisOpenFile(
OUT PNDIS_STATUS Status,
OUT PNDIS_HANDLE FileHandle,
OUT PUINT FileLength,
IN PNDIS_STRING FileName,
IN NDIS_PHYSICAL_ADDRESS HighestAcceptableAddress
);
|
NdisOpenFile 함수는 열린 파일에 대한 핸들을 리턴한다.
매개변수
- Status
- 다음중 하나가 될 수 있는 파일 열기 연산의 상태를 리턴하는 이 함수의 호출자 제공 변수를 가리킨다:
- NDIS_STATUS_SUCCESS
- FileHandle에 핸들은 NdisMapFile 함수로의 순차적인 호출에서 유효하다.
- NDIS_STATUS_FILE_NOT_FOUND
- FileName에 주어진 문자열은 시스템 객체 네임스페이스에서 발견된 이름을 서술하지 않는다.
- NDIS_STATUS_RESOURCES
- NDIS는 파일 내용을 위해서 파일을 열고 버퍼를 할당할 필요가 있는 자원을 할당할 수 없다.
- NDIS_STATUS_ERROR_READING_FILE
- 명시된 파일의 데이타가 호출자의 순차적인 호출에 대해서 시스템 메모리에서 읽을 수 없다.
- FileHandle
- 호출이 성공한다면 열린 파일의 핸들을 리턴하는 이 함수의 호출자 제공 변수를 가리킨다.
- FileLength
- 호출이 성공한다면 열린 파일안에 데이타의 바이트 수를 쓰는 이 함수의 호출자 제공 변수를 가리킨다.
- FileName
- 열리는 파일을 명명하는 시스템 기본 문자집합에서 버퍼화되고 호출자가 초기화한 카운트된 문자열을 가리킨다. 윈도우즈 2000 드라이버에서 이 문자열은 유니코드 문자들을 포함한다.
- HighestAcceptableAddress
- 파일 데이타가 저장될 수 있는 최상위 물리 주소를 서술한다. 혹은 드라이버가 제한없이 위치한다면 -1을 서술한다.
주석
NdisOpenFile 함수는 드라이버가 인공지능의 NIC을 프로그램하기 위해서 후에 다운로드할 파일인 디스크 파일을 연다. NdisOpenFile 함수는 또한 NdisMapFile 함수로의 드라이버의 순차적인 호출에 대해서 파일 내용을 유지하는 저장소를 할당한다.
NIC 드라이버는 MiniportInitialize 함수에서만 NdisOpenFile 함수를 호출할 수 있다.
NdisOpenFile 함수가 리턴할 때 NIC 드라이버는 NdisMapFile 함수를 호출하므로써 파일 데이타로 접근할 수 있다. 드라이버가 파일 데이타로 접근하지 않는 동안에는 불필요하게 자원을 소비하지 않기 위해 파일을 페이지아웃하는 NdisUnmapFile 함수를 호출할 수 있다. 파일 사용이 끝났을 때 MiniportInitialize 함수는 NdisCloseFile 함수를 호출해야한다.
NdisOpenFile 함수의 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.
|