WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE-Enumeration (wdfdevice.h)

Artikel
02/26/2024

[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

Freigeben über