NdisMCreateLog 함수(ndis.h)

NdisMCreateLog 미니포트 드라이버가 드라이버 전용 Win32 애플리케이션에서 표시할 데이터를 쓸 수 있는 로그 파일을 할당하고 엽니다.

통사론

NDIS_STATUS NdisMCreateLog(
  [in]  NDIS_HANDLE  MiniportAdapterHandle,
  [in]  UINT         Size,
  [out] PNDIS_HANDLE LogHandle
);

매개 변수

[in] MiniportAdapterHandle

MiniportInitializeEx 핸들 입력을 지정합니다.

[in] Size

로그 파일에 할당할 바이트 수를 지정합니다. NDIS는 디스크에 저장되지 않은 임시 파일을 만듭니다.

[out] LogHandle

이 함수가 로그 파일에 대한 핸들을 반환하는 호출자 제공 변수에 대한 포인터입니다. 이 핸들은 미니포트 드라이버가 이후에 호출하는 NdisXxxLog 함수에 필요한 매개 변수입니다.

반환 값

NdisMCreateLog 다음 중 하나를 반환할 수 있습니다.

반환 코드	묘사
NDIS_STATUS_SUCCESS	미니포트 드라이버는 LogHandle 반환된 핸들을 사용하여 NDIS 할당 로그 파일에 데이터를 쓸 수 있습니다.
NDIS_STATUS_RESOURCES	지정된 크기의 로그 파일을 할당할 수 없습니다.
NDIS_STATUS_FAILURE	이미 NdisMCreateLog라는 드라이버가 성공적으로.

발언

미니포트 드라이버는 NdisM.을 호출할 수 있습니다. 함수를 기록하여 드라이버 작성기가 선택한 정보를 제공합니다. 드라이버 전용 Win32 애플리케이션에서 미니포트 드라이버 로그를 표시할 수 있습니다. 이러한 애플리케이션은 주기적으로 IOCTL_NDIS_GET_LOG_DATA DeviceIoControl Win32 함수를 호출하여 미니포트 드라이버가 로그 파일에 쓴 내용을 검색합니다. 예를 들어 개발 미달 미니포트 드라이버는 해당 애플리케이션에서 표시할 테스트 데이터를 작성할 수 있습니다.

NdisMCreateLog NDIS_STATUS_RESOURCES 반환하는 경우 드라이버는 원래 크기 아래로 조정하고 이 함수를 다시 호출해 볼 수 있습니다. 그러나 미니포트 드라이버는 호출이 성공한 후 NdisMCreateLog 호출하여 둘 이상의 로그 파일을 만들 수 없습니다.

로그 파일의 크기가 어떤지 간에 NdisMWriteLogData에 대한 후속 호출은 순환 버퍼로 처리되는 이 파일에 데이터를 저장할 있습니다. 즉, NdisMWriteLogData 대한 일련의 호출은 결국 원래 로그 파일에 기록된 데이터를 덮어씁니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista에서 NDIS 6.0 및 NDIS 5.1 드라이버(NdisMCreateLog(NDIS 5.1 참조)에 대해 지원됩니다. Windows XP에서 NDIS 5.1 드라이버(NdisMCreateLog(NDIS 5.1 참조)에 대해 지원됩니다.
대상 플랫폼	보편적
헤더	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	Irql_Miniport_Driver_Function(ndis)

참고 항목

MiniportInitializeEx

NdisMCloseLog

NdisMFlushLog

NdisMWriteLogData