NdisMWriteLogData

NDIS_STATUS NdisMWriteLogData( IN NDIS_HANDLE LogHandle, IN PVOID LogBuffer, IN UINT LogBufferSize );

NdisMWriteLogData 함수는 드라이버에 종속되는 Win32 어플리케이션에 의해서 소비되고 디스플레이되기 위해서 드라이버 제공 정보를 로그파일로 보낸다.

매개변수

LogHandle

NdisMCreateLog 함수에 의해서 리턴된 핸들을 가리킨다.

LogBuffer

쓰여지는 정보를 포함하는 드라이버 할당 버퍼를 가리킨다.

LogBufferSize

로그파일로 얼마나 많은 데이타의 바이트가 복사되는 지를 가리킨다.

리턴값

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

NDIS_STATUS_SUCCESS

LogBuffer에 드라이버 제공 데이타가 로그파일 안으로 복사됐다.

NDIS_STATUS_BUFFER_OVERFLOW

주어진 LogBufferSize가 너무 크다. 즉 로그 파일 자체보다 크다.

주석

드라이버에 종속되는 어플리케이션이 로그 파일 데이타를 위해서 두드러진 리퀘스트를 한다면 NdisMWriteLogData 함수는 드라이버 제공 정보가 로그 파일로 복사되자마자 그 리퀘스트를 만족시킨다.

미니포트가 현재 IRQL < DISPATCH_LEVEL에서 실행중이라면 미니포트는 LogBuffer의 포인터를 커널 스택의 로케이션으로 제공할 수 있다. 그렇지 않으면 LogBuffer는 드라이버가 비페이지화된 풀에 할당한 버퍼로 접근해야한다.

NdisMWriteLogData 함수를 호출하기 전에 드라이버는 유지하고 있는 스핀락을 해제해야한다.

NdisMWriteLogData 함수는 로그 기록 사이의 경계를 인식하지 못한다. 어플리케이션이 NDIS NIC 드라이버에 의해서 NDIS 로그 파일로 쓰여진 데이타를 얻기 위해서 IOCTL_NDIS_GET_LOG_DATA를 가지고 호출할 수 있는 Win32 함수인 DeviceIoControl 함수도 그러하다. NdisMWriteLogData 함수는 LogBuffer에 모든 미니포트 제공 데이타를 바이트 스트림으로 로그 파일에 쓴다. DeviceIoControl 함수는 마찬가지로 바이트 스트림으로써 그러한 로그로부터 데이타를 읽는다.

결국 NDIS 로그를 읽는 어플리케이션은 얻은 데이타를 레코드에 수집해야한다. 그러한 어플리케이션이 변할 수 있는 길이의 레코드의 수집을 돕기 위해서 그러한 로그에 쓰는 미니포트는 각각의 레코드의 시작에서 판별자를 삽입할 수 있다. 그리고나서 얻은 데이타를 포맷하는 어플리케이션은 이 판별자로 각각의 레코드 시작을 찾을 수 있다.

NdisMWriteLogData 함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행할 수 있다.