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 :
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) |