NdisMCreateLog

NDIS_STATUS NdisMCreateLog( IN NDIS_HANDLE MiniportAdapterHandle, IN UINT Size, OUT PNDIS_HANDLE LogHandle );

NdisMCreateLog 함수는 NIC 미니포트가 드라이버 종속 Win32 어플리케이션에 의해서 진열되는 데이타를 쓸수 있는 로그 파일 을 할당하고 연다.

매개변수

MiniportAdapterHandle

MiniportInitialize 함수로 입력되는 핸들을 서술한다.

Size

로그 파일에 대해서 얼마나 많은 바이트가 할당됐는지를 서술한다. NDIS는 디스크네 저장되지 않은 임시 파일을 생성한다.

LogHandle

로그 파일에 대한 핸들을 리턴하는 이 함수의 호출자 제공 변수를 가리킨다. 이 핸들은 미니포트가 순차적으로 호출하는 Ndis..Log 함수에게는 필요한 매개변수이다.

리턴값

NdisMCreateLog 함수는 다음중 하나를 리턴할 수 있다:

NDIS_STATUS_SUCCESS

미니포트는 NDIS 할당 로그 파일에 데이타를 쓰기 위해서 LogHandle에 리턴된 핸들을 사용할 수 있다.

NDIS_STATUS_RESOURCES

명시된 사이즈의 로그 파일이 할당되지 않았다.

NDIS_STATUS_FAILURE

드라이버가 이미 NdisMCreateLog 함수의 호출을 성공했다.

주석

NIC 미니포트는 드라이버 개발자가 선택한 정보를 제공하기 위해서 NdisM..Log 함수를 호출할 수 있다. 미니포트 로그가 무엇이든지 드라이버 종속 Win32 어플리케이션에 의해서 진열될 수 있다. 그러한 어플리케이션은 미니포트가 로그 파일에 무엇을 썼는지 얻어오기 위해서 정기적으로 IOCTL_NDIS_GET_LOG_DATA를 가지고 Win32 함수인 DeviceIoControl 함수를 호출한다. 예를들어 개발중인 미니포트는 대응하는 어플리케이션에 의해서 진열된 테스트 데이타를 쓴다.

NdisMCreateLog 함수가 NDIS_STATUS_RESOURCES를 리턴한다면 드라이버는 원래의 사이즈를 하향조정하고 다시 이 함수를 호출한다. 그러나 미니포트는 호출을 성공한 후에는 하나이상의 로그 파일을 생성하기 위해서 NdisMCreateLog 함수를 호출할 수 없다.

로그 파일의 사이즈가 얼마만큼 할당되든지간에 NdisMWriteLogData 함수로의 순차적인 호출은 원형 버퍼로 다뤄지는 이 파일안에 데이타를 저장한다. 즉 NdisMWriteLogData 함수로의 순차적인 호출은 원래 로그 파일에 쓰여진 데이타에 덮어쓴다.

NdisMCreateLog 함수의 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.