피드백

NdisMCreateLog 함수(ndis.h)

  • 아티클
  • 읽는 데 3분 걸림

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 Win32 함수 DeviceIoControl 을 호출하여 미니포트 드라이버가 로그 파일에 쓴 내용을 검색합니다. 예를 들어 개발 중인 미니포트 드라이버는 해당 애플리케이션에서 표시할 테스트 데이터를 작성할 수 있습니다.

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