EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX 콜백 함수(wdfdevice.h)

[KMDF 및 UMDF에 적용]

드라이버의 EvtDeviceUsageNotificationEx 이벤트 콜백 함수는 디바이스가 특수 파일 형식을 지원할 수 있는지 여부를 결정합니다.

통사론

EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX EvtWdfDeviceUsageNotificationEx;

NTSTATUS EvtWdfDeviceUsageNotificationEx(
  [in] WDFDEVICE Device,
  [in] WDF_SPECIAL_FILE_TYPE NotificationType,
  [in] BOOLEAN IsInNotificationPath
)
{...}

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

[in] NotificationType

시스템이 지정된 디바이스에 저장하는 특수 파일의 형식을 식별하는 WDF_SPECIAL_FILE_TYPE형식화된 값입니다.

[in] IsInNotificationPath

TRUE 경우 시스템이 특수 파일을 사용하기 시작했음을 나타내고, FALSE 경우 시스템이 특수 파일 사용을 완료했음을 나타내는 부울 값입니다.

반환 값

드라이버가 디바이스가 특수 파일을 지원할 수 있다고 판단하는 경우 EvtDeviceUsageNotificationEx 콜백 함수는 STATUS_SUCCESS 또는 NT_SUCCESS(상태)가 TRUE 다른 상태 값을 반환해야 합니다. 그렇지 않으면 NT_SUCCESS(상태)가 false 상태 값을 반환해야 합니다.

발언

드라이버가 특수 파일의 드라이버별 처리를 제공해야 하는 경우 EvtDeviceUsageNotificationEx 또는 EvtDeviceUsageNotification 이벤트 콜백 함수를 제공해야 합니다. 두 콜백 함수를 모두 제공하지 마세요.

EvtDeviceUsageNotificationEx 콜백 함수를 등록하려면 드라이버가 WdfDeviceInitSetPnpPowerEventCallbacks호출해야 합니다.

드라이버의 EvtDeviceUsageNotificationEx 콜백 함수가 실패 상태를 반환하는 경우 프레임워크는 이전에 통보했을 수 있는 다른 스택으로 오류를 전파합니다.

특수 파일에 대한 자세한 내용은 지원 특수 파일참조하세요.

요구 사항

요구	값
대상 플랫폼	보편적
최소 KMDF 버전	1.11
최소 UMDF 버전	2.0
헤더	wdfdevice.h(Wdf.h 포함)
IRQL	PASSIVE_LEVEL