WdfDeviceGetDevicePowerPolicyState, fonction (wdfdevice.h)
[S’applique uniquement à KMDF]
Note
Cette fonction est destinée uniquement à l’utilisation interne de Microsoft.
La méthode WdfDeviceGetDevicePowerPolicyState retourne l’état actuel de l’ordinateur d’état de stratégie d’alimentation du framework, pour un appareil spécifié.
Syntaxe
WDF_DEVICE_POWER_POLICY_STATE WdfDeviceGetDevicePowerPolicyState(
[in] WDFDEVICE Device
);
Paramètres
[in] Device
Handle vers un objet d’appareil framework.
Valeur de retour
WdfDeviceGetDevicePowerPolicyState retourne un énumérateur WDF_DEVICE_POWER_POLICY_STATE-typé qui identifie l’état actuel de la machine d’état de stratégie d’alimentation du framework pour l’appareil spécifié.
Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.
Remarques
Pour plus d’informations sur les machines d’état du framework, consultez Machines d’état dans le framework.
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 l’ordinateur d’état de stratégie d’alimentation du framework pour un appareil spécifié.
WDF_DEVICE_POWER_POLICY_STATE devicePowerPolicyState;
devicePowerPolicyState = WdfDeviceGetDevicePowerPolicyState(Device);
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| d’en-tête | wdfdevice.h (include Wdf.h) |
| bibliothèque | Wdf01000.sys (voir Versioning de la bibliothèque Framework.) |
| IRQL | <= DISPATCH_LEVEL |
| règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |