다음을 통해 공유

WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE 열거형(wdfdevice.h)

[KMDF 및 UMDF에 적용]

WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE 열거형은 프레임워크가 드라이버의 EvtDeviceReleaseHardware 콜백 함수를 호출할 때 지정합니다.

통사론

typedef enum _WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE {
  WdfReleaseHardwareOrderOnFailureInvalid = 0,
  WdfReleaseHardwareOrderOnFailureEarly,
  WdfReleaseHardwareOrderOnFailureAfterDescendants
} WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE, *PWDF_RELEASE_HARDWARE_ORDER_ON_FAILURE;

상수

 
WdfReleaseHardwareOrderOnFailureInvalid
값: 0
시스템 사용을 위해 예약되어 있습니다.
WdfReleaseHardwareOrderOnFailureEarly
특정 오류 조건을 제외하고 프레임워크는 드라이버가 열거하는 모든 자식 디바이스에 대해 EvtDeviceReleaseHardware 함수를 호출한 후 드라이버의 EvtDeviceReleaseHardware 콜백 함수를 호출합니다. 자세한 내용은 비고를 참조하세요.
WdfReleaseHardwareOrderOnFailureAfterDescendants
프레임워크는 드라이버가 열거하는 모든 자식 디바이스에 대해 EvtDeviceReleaseHardware 함수를 호출한 후 항상 드라이버의 EvtDeviceReleaseHardware 콜백 함수를 호출합니다.

발언

WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE 열거형은 WdfDeviceInitSetReleaseHardwareOrderOnFailure 입력으로 사용됩니다.

드라이버가 WdfReleaseHardwareOrderOnFailureEarly 지정하는 경우 일반 디바이스 제거 시 프레임워크는 드라이버가 열거하는 모든 자식 디바이스에 대해 EvtDeviceReleaseHardware 함수를 호출한 후 드라이버의 EvtDeviceReleaseHardware 호출합니다. 그러나 디바이스 전원이 켜지거나 전원이 끊기는 경우 프레임워크는 모든 자식 디바이스에 대한 EvtDeviceReleaseHardware 함수를 호출하기 전에 드라이버의 EvtDeviceReleaseHardware 호출할 수 있습니다.

드라이버가 WdfReleaseHardwareOrderOnFailureAfterDescendants 지정하는 경우 프레임워크는 자식 디바이스의 EvtDeviceReleaseHardware 함수를 호출할 때까지 드라이버의 EvtDeviceReleaseHardware 호출하기 위해 대기합니다.

요구 사항

요구 값
최소 KMDF 버전 1.11
최소 UMDF 버전 2.0
헤더 wdfdevice.h(Wdf.h 포함)

참고 항목

EvtDeviceReleaseHardware

WdfDeviceInitSetReleaseHardwareOrderOnFailure