enumerasi WDF_DEVICE_FAILED_ACTION (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Enumerasi WDF_DEVICE_FAILED_ACTION mengidentifikasi tindakan yang akan diambil kerangka kerja ketika driver melaporkan kegagalan perangkat lunak atau perangkat keras yang tidak dapat dipulihkan.

Sintaks

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

Konstanta

 
WdfDeviceFailedUndefined
Nilai: 0
Hanya untuk penggunaan internal.
WdfDeviceFailedAttemptRestart
Didukung di KMDF dan dimulai di UMDF versi 2.15. Jika driver perangkat tidak mendukung perangkat lain yang dicolokkan ke komputer, manajer I/O akan membongkar driver. Selanjutnya, manajer Plug and Play mencoba memulai ulang perangkat dengan meminta driver bus untuk menghitung ulang perangkatnya. Jika pengemudi bus mendukung reenumerasi, driver Anda akan dimuat ulang, jika dibongkar. Jika beberapa upaya hidupkan ulang berturut-turut gagal (karena driver yang dimulai ulang kembali melaporkan kesalahan), kerangka kerja berhenti mencoba memulai ulang perangkat.
WdfDeviceFailedNoRestart
Jika driver perangkat tidak mendukung perangkat lain pada sistem, manajer I/O akan membongkar driver.

Keterangan

Enumerasi WDF_DEVICE_FAILED_ACTION digunakan sebagai argumen input untuk WdfDeviceSetFailed.

Driver biasanya menentukan WdfDeviceFailedAttemptRestart jika mengalami kesalahan perangkat lunak yang tidak dapat dipulihkan, karena menentukan enumerator ini memuat ulang driver. Driver mungkin menentukan WdfDeviceFailedNoRestart jika mengalami kesalahan perangkat keras yang tidak dapat dipulihkan yang memengaruhi semua perangkat driver.

Untuk informasi tentang menentukan WdfDeviceFailedAttemptRestart dalam driver UMDF, lihat Komentar WdfDeviceSetFailed.

Persyaratan

Persyaratan Nilai
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfdevice.h (termasuk Wdf.h)

Lihat juga

WdfDeviceSetFailed