enumerazione WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE (wdfdevice.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

L'enumerazione WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE specifica quando il framework chiama la funzione di callback di un driver EvtDeviceReleaseHard ware.

Sintassi

typedef enum _WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE {
  WdfReleaseHardwareOrderOnFailureInvalid = 0,
  WdfReleaseHardwareOrderOnFailureEarly,
  WdfReleaseHardwareOrderOnFailureAfterDescendants
} WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE, *PWDF_RELEASE_HARDWARE_ORDER_ON_FAILURE;

Costanti


`WdfReleaseHardwareOrderOnFailureInvalid` Valore: 0 Riservato per l'uso del sistema.
`WdfReleaseHardwareOrderOnFailureEarly` Ad eccezione di determinate condizioni di errore, il framework chiama il driver EvtDeviceReleaseHardware funzione di callback dopo aver chiamato la funzione EvtDeviceReleaseHardware per tutti i dispositivi figlio enumerati dal driver. Per altre informazioni, vedere Osservazioni.
`WdfReleaseHardwareOrderOnFailureAfterDescendants` Il framework chiama sempre il evtDeviceReleaseHardware funzione di callback dopo aver chiamato la funzione EvtDeviceReleaseHardware per tutti i dispositivi figlio enumerati dal driver.

Osservazioni

L'enumerazione WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE viene usata come input per WdfDeviceInitSetReleaseHardwareOrderOnFailure.

Se un driver specifica WdfReleaseHardwareOrderOnFailureEarly, quindi nella normale rimozione del dispositivo, il framework chiama il EvtDeviceReleaseHardware dopo aver chiamato la funzione EvtDeviceReleaseHardware per tutti i dispositivi figlio enumerati dal driver. Tuttavia, in caso di guasto dell'alimentazione o del risparmio di energia del dispositivo, il framework potrebbe chiamare il EvtDeviceReleaseHardware prima che abbia chiamato le funzioni EvtDeviceReleaseHardware per tutti i dispositivi figlio.

Se un driver specifica WdfReleaseHardwareOrderOnFailureAfterDescendants, il framework attende di chiamare il EvtDeviceReleaseHardware del driver finché non ha chiamato le funzioni EvtDeviceReleaseHardware.

Fabbisogno

Requisito	Valore
versione minima di KMDF	1.11
versione minima di UMDF	2.0
intestazione	wdfdevice.h (include Wdf.h)

Vedere anche

EvtDeviceReleaseHardware

WdfDeviceInitSetReleaseHardwareOrderOnFailure

Condividi tramite