WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE 열거형(wdfdevice.h)

  • 아티클

[KMDF 및 UMDF에 적용]

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

Syntax

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