GetDevicePowerState, fonction (winbase.h)

Récupère l’état d’alimentation actuel de l’appareil spécifié. Cette fonction ne peut pas être utilisée pour interroger l’état d’alimentation d’un périphérique d’affichage.

Syntaxe

BOOL GetDevicePowerState(
  [in]  HANDLE hDevice,
  [out] BOOL   *pfOn
);

Paramètres

[in] hDevice

Handle vers un objet sur l’appareil, tel qu’un fichier ou un socket, ou un handle pour l’appareil lui-même.

[out] pfOn

Pointeur vers la variable qui reçoit l’état d’alimentation. Cette valeur est TRUE si l’appareil est dans l’état de fonctionnement. Sinon, elle est FALSE.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Une application peut utiliser GetDevicePowerState pour déterminer si un appareil est à l’état opérationnel ou à faible consommation d’énergie. Si l’appareil est dans un état de faible consommation, l’accès à l’appareil peut entraîner la mise en file d’attente ou l’échec des demandes d’E/S, ou faire passer l’appareil à l’état opérationnel. Le comportement exact dépend de l’implémentation de l’appareil.

Pour garantir une autonomie maximale de la batterie sur un ordinateur portable, utilisez GetDevicePowerState pour réduire la consommation d’énergie. Par exemple, si un disque est actuellement hors tension, l’accès au disque entraîne sa rotation, ce qui augmente la consommation d’énergie et réduit l’autonomie de la batterie.

Les applications doivent différer ou limiter l’accès aux appareils dans la mesure du possible pendant que le système fonctionne sur batterie. Pour déterminer si le système fonctionne sur batterie et l’autonomie restante de la batterie, utilisez la fonction GetSystemPowerStatus .

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbase.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

GetSystemPowerStatus

Fonctions de gestion de l’alimentation

État de l’alimentation du système