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 qui sont 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) a la valeur TRUE. Sinon, il doit retourner une valeur d’état pour laquelle NT_SUCCESS(status) est 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. 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 la fonction de rappel EvtInterruptDisable .

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.

Configuration requise

   
Plateforme cible Universal
Version KMDF minimale 1.0
Version UMDF minimale 2,0
En-tête wdfdevice.h (include Wdf.h)
IRQL PASSIVE_LEVEL (voir la section Remarques)

Voir aussi

EvtDeviceD0EntryPostInterruptsEnabled