Share via

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

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

반환 값

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