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