WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE-Aufzählung (wdfdevice.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE-Aufzählung 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 Reserviert für die Systemverwendung.
`WdfReleaseHardwareOrderOnFailureEarly` Mit Ausnahme bestimmter Fehlerbedingungen ruft das Framework die EvtDeviceReleaseHardware Rückruffunktion auf, nachdem sie 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 auf, nachdem sie die EvtDeviceReleaseHardware Funktion für alle untergeordneten Geräte aufgerufen hat, die der Treiber aufzählt.

Bemerkungen

Die WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE-Aufzählung wird als Eingabe für WdfDeviceInitSetReleaseHardwareOrderOnFailureverwendet.

Wenn ein Treiber WdfReleaseHardwareOrderOnFailureEarlyangibt, ruft das Framework die EvtDeviceReleaseHardware auf, nachdem er den EvtDeviceReleaseHardware Funktion für alle untergeordneten Geräte aufruft, die der Treiber aufzählt. Im Falle eines Ein- oder Ausschaltens eines Geräts ruft das Framework möglicherweise die EvtDeviceReleaseHardware- des Treibers auf, bevor es die EvtDeviceReleaseHardware- Funktionen für alle untergeordneten Geräte aufgerufen hat.

Wenn ein Treiber WdfReleaseHardwareOrderOnFailureAfterDescendantsangibt, wartet das Framework darauf, die EvtDeviceReleaseHardware aufzurufen, bis er den EvtDeviceReleaseHardware- Funktionen der untergeordneten Geräte aufgerufen hat.

Anforderungen

Anforderung	Wert
Minimale KMDF-Version	1.11
Mindest-UMDF-Version	2.0
Header-	wdfdevice.h (einschließen Wdf.h)

Siehe auch

EvtDeviceReleaseHardware

WdfDeviceInitSetReleaseHardwareOrderOnFailure

Freigeben über