EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS fonction de rappel (wdfpdo.h)

  • Article

[S’applique à KMDF uniquement]

La fonction de rappel d’événement EvtDeviceEnableWakeAtBus d’un pilote de bus effectue des opérations au niveau du bus qui permettent à l’un des appareils du bus de déclencher un signal de mise en éveil sur le bus.

Syntaxe

EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS EvtWdfDeviceEnableWakeAtBus;

NTSTATUS EvtWdfDeviceEnableWakeAtBus(
  [in] WDFDEVICE Device,
  [in] SYSTEM_POWER_STATE PowerState
)
{...}

Paramètres

[in] Device

Handle pour un objet d’appareil d’infrastructure.

[in] PowerState

Énumérateur SYSTEM_POWER_STATE qui identifie l’état d’alimentation du système à partir duquel le système ou l’appareil sortira.

Valeur retournée

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

Si NT_SUCCESS(status) a la valeur FALSE, l’infrastructure appelle la fonction de rappel EvtDeviceDisableWakeAtBus du pilote.

Pour plus d’informations sur les valeurs de retour de cette fonction de rappel, consultez Signalement des défaillances d’appareils.

Remarques

Pour inscrire cette fonction de rappel, le pilote de bus doit appeler WdfPdoInitSetEventCallbacks.

Pour plus d’informations sur cette fonction de rappel, consultez Prise en charge du réveil du système.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdfpdo.h (inclure Wdf.h)
IRQL PASSIVE_LEVEL

Voir aussi

WdfPdoInitSetEventCallbacks

EvtDeviceDisableWakeAtBus