WdfDeviceGetDevicePowerPolicyState, fonction (wdfdevice.h)
[S’applique uniquement à KMDF]
Notes
Cette fonction est destinée à un usage interne Microsoft uniquement.
La méthode WdfDeviceGetDevicePowerPolicyState retourne l’état actuel de la machine d’état de stratégie d’alimentation de l’infrastructure, pour un appareil spécifié.
Syntaxe
WDF_DEVICE_POWER_POLICY_STATE WdfDeviceGetDevicePowerPolicyState(
[in] WDFDEVICE Device
);
Paramètres
[in] Device
Handle d’un objet d’appareil framework.
Valeur retournée
WdfDeviceGetDevicePowerPolicyState retourne un énumérateur de type WDF_DEVICE_POWER_POLICY_STATE qui identifie l’état actuel de la machine d’état de la stratégie 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 WdfDeviceGetDevicePowerPolicyState retourne une valeur significative uniquement si elle est appelée à partir des fonctions de rappel que le pilote inscrit lorsqu’il appelle WdfDeviceInitSetPowerPolicyEventCallbacks.
Exemples
L’exemple de code suivant obtient l’état actuel de la machine d’état de stratégie d’alimentation du framework pour un appareil spécifié.
WDF_DEVICE_POWER_POLICY_STATE devicePowerPolicyState;
devicePowerPolicyState = WdfDeviceGetDevicePowerPolicyState(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) |