다음을 통해 공유


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