énumération WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE (wdfdevice.h)

Article
02/07/2025

[S’applique à KMDF et UMDF]

L’énumération WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE spécifie quand l’infrastructure appelle la fonction de rappel evtDeviceReleaseHardware evtDeviceReleaseHardware.

Syntaxe

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

Constantes


`WdfReleaseHardwareOrderOnFailureInvalid` Valeur : 0 Réservé à l’utilisation du système.
`WdfReleaseHardwareOrderOnFailureEarly` Sauf dans certaines conditions d’erreur, l’infrastructure appelle la fonction de rappel EvtDeviceReleaseHardware après avoir appelé la fonction EvtDeviceReleaseHardware pour tous les périphériques enfants que le pilote énumère. Pour plus d’informations, consultez Remarques.
`WdfReleaseHardwareOrderOnFailureAfterDescendants` L’infrastructure appelle toujours la fonction de rappel EvtDeviceReleaseHardware après avoir appelé le EvtDeviceReleaseHardware fonction pour tous les périphériques enfants que le pilote énumère.

Remarques

L’énumération WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE est utilisée comme entrée pour WdfDeviceInitSetReleaseHardwareOrderOnFailure.

Si un pilote spécifie WdfReleaseHardwareOrderOnFailureEarly, puis dans la suppression normale de l’appareil, l’infrastructure appelle le EvtDeviceReleaseHardware après avoir appelé le EvtDeviceReleaseHardware fonction pour tous les périphériques enfants que le pilote énumère. Toutefois, en cas de panne d’alimentation ou de mise hors tension de l’appareil, l’infrastructure peut appeler le EvtDeviceReleaseHardware du pilote avant d’appeler le EvtDeviceReleaseHardware fonctions pour tous les appareils enfants.

Si un pilote spécifie WdfReleaseHardwareOrderOnFailureAfterDescendants, l’infrastructure attend d’appeler le EvtDeviceReleaseHardware du pilote jusqu’à ce qu’il ait appelé le EvtDeviceReleaseHardware fonctions des appareils enfants.

Exigences

Exigence	Valeur
version minimale de KMDF	1.11
version minimale de UMDF	2.0
d’en-tête	wdfdevice.h (include Wdf.h)

Voir aussi

EvtDeviceReleaseHardware

WdfDeviceInitSetReleaseHardwareOrderOnFailure

Partager via