Fonction WdfDeviceGetDevicePowerState (wdfdevice.h)

[S’applique uniquement à KMDF]

Notes

Cette fonction est destinée uniquement à l’usage interne de Microsoft.

La méthode WdfDeviceGetDevicePowerState retourne l’état actuel de la machine d’état d’alimentation de l’infrastructure, pour un appareil spécifié.

Syntaxe

WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
  [in] WDFDEVICE Device
);

Paramètres

[in] Device

Handle d’un objet d’appareil framework.

Valeur retournée

WdfDeviceGetDevicePowerState retourne un énumérateur de type WDF_DEVICE_POWER_STATE qui identifie l’état actuel de la machine d’état d’alimentation de l’infrastructure pour l’appareil spécifié.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Pour plus d’informations sur les machines d’état de l’infrastructure, consultez Machines d’état dans l’infrastructure.

La méthode WdfDeviceGetDevicePowerState retourne une valeur significative uniquement si elle est appelée à partir des fonctions de rappel suivantes :

• EvtDevicePrepareHardware

• EvtDeviceReleaseHardware

• EvtDeviceD0Entry

• EvtDeviceD0EntryPostInterruptsEnabled

• EvtDeviceD0Exit

• EvtDeviceD0ExitPreInterruptsDisabled

• EvtDeviceSelfManagedIoInit

• EvtDeviceSelfManagedIoSuspend

• EvtDeviceSelfManagedIoRestart

Exemples

L’exemple de code suivant obtient l’état actuel de la machine d’état d’alimentation de l’infrastructure pour un appareil spécifié.

WDF_DEVICE_POWER_STATE state;

state = WdfDeviceGetDevicePowerState(Device);

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdfdevice.h (include Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerPolicyState