WdfDeviceGetDevicePowerState, fonction (wdfdevice.h)
[S’applique uniquement à KMDF]
Note
Cette fonction est destinée uniquement à l’utilisation interne de Microsoft.
La méthode WdfDeviceGetDevicePowerState retourne l’état actuel de l’ordinateur d’état d’alimentation du framework, pour un appareil spécifié.
Syntaxe
WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
[in] WDFDEVICE Device
);
Paramètres
[in] Device
Handle vers un objet d’appareil framework.
Valeur de retour
WdfDeviceGetDevicePowerState retourne un énumérateur WDF_DEVICE_POWER_STATE-typé qui identifie l’état actuel de l’ordinateur d’état 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 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 l’ordinateur d’état d’alimentation du framework pour un appareil spécifié.
WDF_DEVICE_POWER_STATE state;
state = WdfDeviceGetDevicePowerState(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) |