WDF_DEVICE_FAILED_ACTION 열거형(wdfdevice.h)

  • 아티클

[KMDF 및 UMDF에 적용]

WDF_DEVICE_FAILED_ACTION 열거형은 드라이버가 복구할 수 없는 소프트웨어 또는 하드웨어 오류를 보고할 때 프레임워크가 수행할 작업을 식별합니다.

Syntax

typedef enum _WDF_DEVICE_FAILED_ACTION {
  WdfDeviceFailedUndefined = 0,
  WdfDeviceFailedAttemptRestart,
  WdfDeviceFailedNoRestart
} WDF_DEVICE_FAILED_ACTION;

상수

 
WdfDeviceFailedUndefined
값: 0
내부 전용입니다.
WdfDeviceFailedAttemptRestart
KMDF에서 지원되며 UMDF 버전 2.15부터 지원됩니다. 디바이스 드라이버가 컴퓨터에 연결된 다른 디바이스를 지원하지 않는 경우 I/O 관리자는 드라이버를 언로드합니다. 다음으로, 플러그 앤 플레이 관리자는 버스 드라이버에 디바이스를 다시 열거하도록 요청하여 디바이스를 다시 시작하려고 시도합니다. 버스 드라이버가 다시 활성화를 지원하는 경우 언로드된 경우 드라이버가 다시 로드됩니다. 다시 시작한 드라이버가 오류를 다시 보고하기 때문에 여러 번의 연속 다시 시작 시도가 실패하면 프레임워크에서 디바이스 다시 시작 시도를 중지합니다.
WdfDeviceFailedNoRestart
디바이스의 드라이버가 시스템의 다른 디바이스를 지원하지 않는 경우 I/O 관리자는 드라이버를 언로드합니다.

설명

WDF_DEVICE_FAILED_ACTION 열거형은 WdfDeviceSetFailed에 대한 입력 인수로 사용됩니다.

드라이버는 일반적으로 복구할 수 없는 소프트웨어 오류가 발생하는 경우 WdfDeviceFailedAttemptRestart 를 지정합니다. 이 열거자를 지정하면 드라이버가 다시 로드되기 때문입니다. 드라이버가 모든 드라이버의 디바이스에 영향을 주는 복구할 수 없는 하드웨어 오류가 발생하는 경우 WdfDeviceFailedNoRestart 를 지정할 수 있습니다.

UMDF 드라이버에서 WdfDeviceFailedAttemptRestart 를 지정하는 방법에 대한 자세한 내용은 WdfDeviceSetFailed의 설명을 참조하세요.

요구 사항

요구 사항 값
최소 KMDF 버전 1.0
최소 UMDF 버전 2.0
머리글 wdfdevice.h(Wdf.h 포함)

추가 정보

WdfDeviceSetFailed