Share via

WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE-Enumeration (wdfdevice.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE-Enumeration gibt an, wann das Framework die EvtDeviceReleaseHardware-Rückruffunktion eines Treibers aufruft.

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;

Konstanten

 
WdfReleaseHardwareOrderOnFailureInvalid
Wert: 0
Ist für das System reserviert.
WdfReleaseHardwareOrderOnFailureEarly
Außer unter bestimmten Fehlerbedingungen ruft das Framework die EvtDeviceReleaseHardware-Rückruffunktion des Treibers auf, nachdem es die EvtDeviceReleaseHardware-Funktion für alle untergeordneten Geräte aufgerufen hat, die der Treiber aufzählt. Weitere Informationen finden Sie in den Hinweisen.
WdfReleaseHardwareOrderOnFailureAfterDescendants
Das Framework ruft immer die EvtDeviceReleaseHardware-Rückruffunktion des Treibers auf, nachdem es die EvtDeviceReleaseHardware-Funktion für alle untergeordneten Geräte aufgerufen hat, die der Treiber aufzählt.

Hinweise

Die WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE-Enumeration wird als Eingabe für WdfDeviceInitSetReleaseHardwareOrderOnFailure verwendet.

Wenn ein Treiber WdfReleaseHardwareOrderOnFailureEarly angibt, ruft das Framework bei normaler Geräteentfernung die EvtDeviceReleaseHardware des Treibers auf, nachdem es die EvtDeviceReleaseHardware-Funktion für alle untergeordneten Geräte aufgerufen hat, die der Treiber aufzählt. Im Falle eines Gerätein- oder Herunterschaltfehlers kann das Framework jedoch evtDeviceReleaseHardware des Treibers aufrufen, bevor es die EvtDeviceReleaseHardware-Funktionen für alle untergeordneten Geräte aufgerufen hat.

Wenn ein Treiber WdfReleaseHardwareOrderOnFailureAfterDescendants angibt, wartet das Framework darauf, die EvtDeviceReleaseHardware des Treibers aufzurufen, bis es die EvtDeviceReleaseHardware-Funktionen der untergeordneten Geräte aufgerufen hat.

Anforderungen

Anforderung Wert
KMDF-Mindestversion 1.11
UMDF-Mindestversion 2.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)

Weitere Informationen

EvtDeviceReleaseHardware

WdfDeviceInitSetReleaseHardwareOrderOnFailure