Share via

Événement PBT_APMPOWERSTATUSCHANGE

  • Article

Avertit les applications d'une modification de l'état de l'alimentation de l'ordinateur, comme un commutateur de l'alimentation de la batterie au secteur. Le système diffuse également cet événement lorsque la batterie restante glisse en dessous du seuil spécifié par l'utilisateur ou si l'alimentation de la batterie change d'un pourcentage spécifié.

Une fenêtre reçoit cet événement via le message WM_POWERBROADCAST. Les paramètres wParam et lParam sont définis comme décrit ci-dessous.

LRESULT 
CALLBACK 
WindowProc( HWND hwnd,      // handle to window
            UINT uMsg,      // WM_POWERBROADCAST
            WPARAM wParam,  // PBT_APMPOWERSTATUSCHANGE
            LPARAM lParam); // zero

Paramètres

hwnd

Handle à fenêtre.

uMsg

Valeur Signification
WM_POWERBROADCAST
536 (0x218)
 Identificateur du message.

wParam

Valeur Signification
PBT_APMPOWERSTATUSCHANGE
10 (0xA)
 Identificateur de l'événement.

lParam

Réservé ; doit être égal à zéro.

Valeur retournée

Aucune valeur renvoyée.

Notes

Une application doit traiter cet événement en appelant la fonction GetSystemPowerStatus pour récupérer l'état actuel de l'alimentation de l'ordinateur. En particulier, l'application doit vérifier s'il y a eu des modifications quelconques des membres ACLineStatus, BatteryFlag, BatteryLifeTime et BatteryLifePercent de la structure SYSTEM_POWER_STATUS. Cet événement peut se produire lorsque la durée de vie de la batterie passe à moins de 5 minutes, ou lorsque le pourcentage de durée de vie de la batterie passe en dessous de 10 % ou si la durée de vie de la batterie change de 3 %.

Spécifications

Condition requise Value
Client minimal pris en charge
 Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows Server 2003 [applications de bureau uniquement]
En-tête
WinUser.h (inclus dans Windows.h)

Voir aussi