EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED fonction de rappel (wdfdevice.h)

[S’applique à KMDF et UMDF]

La fonction de rappel d’événement evtDeviceD0ExitPreInterruptsDisabled d’un pilote effectue des opérations spécifiques à l’appareil requises avant que le pilote ne désactive les interruptions matérielles de l’appareil.

Syntaxe

EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED EvtWdfDeviceD0ExitPreInterruptsDisabled;

NTSTATUS EvtWdfDeviceD0ExitPreInterruptsDisabled(
  [in] WDFDEVICE Device,
  [in] WDF_POWER_DEVICE_STATE TargetState
)
{...}

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

[in] TargetState

Énumérateur WDF_POWER_DEVICE_STATE-typé qui identifie l’état d’alimentation de l’appareil que l’appareil est sur le point d’entrer.

Valeur de retour

Si la fonction de rappel EvtDeviceD0ExitPreInterruptsDisabled ne rencontre aucune erreur, elle doit retourner STATUS_SUCCESS ou une autre valeur d’état pour laquelle NT_SUCCESS(status) est égal à TRUE. Sinon, il doit retourner une valeur d’état pour laquelle NT_SUCCESS(état) est égal à FALSE.

Pour plus d’informations sur les valeurs de retour de cette fonction de rappel, consultez Reporting Device Failures.

Remarques

Pour inscrire une fonction de rappel EvtDeviceD0ExitPreInterruptsDisabled, un pilote doit appeler WdfDeviceInitSetPnpPowerEventCallbacks.

La fonction de rappel EvtDeviceD0ExitPreInterruptsDisabled est appelée à IRQL = PASSIVE_LEVEL, avant que l’infrastructure appelle la fonction de rappel EvtInterruptDisable du pilote fonction de rappel. Un pilote peut fournir cette fonction s’il doit effectuer des opérations spécifiques à l’appareil avant de désactiver une interruption, si ces opérations ne doivent pas être effectuées à IRQL = DIRQL dans le EvtInterruptDisable fonction de rappel.

Pour plus d’informations sur le moment où l’infrastructure appelle cette fonction de rappel, consultez scénarios PnP et Power Management.

Pour plus d’informations sur la gestion des interruptions, consultez Gestion des interruptions matérielles.

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	wdfdevice.h (include Wdf.h)
IRQL	PASSIVE_LEVEL (voir la section Remarques)

Voir aussi

EvtDeviceD0EntryPostInterruptsEnabled