_Message WM POWERBROADCAST
Avertit les applications qu’un événement de gestion de l’alimentation s’est produit.
Une fenêtre reçoit ce message par le biais de sa fonction WindowProc .
LRESULT CALLBACK WindowProc(
HWND hwnd, // handle to window
UINT uMsg, // WM_POWERBROADCAST
WPARAM wParam, // power-management event
LPARAM lParam // function-specific data
);
Paramètres
-
HWND
-
Handle de fenêtre.
- *uMsg*
-
Valeur Signification - * * * *
- WM _ POWERBROADCAST * * * *
- 536 (0x218)
Identificateur du message. -
wParam
-
Événement de gestion de l’alimentation. Ce paramètre peut être l’un des identificateurs d’événements suivants.
Événement Signification - PBT _ APMPOWERSTATUSCHANGE
- 10 (0xA)
L’état de l’alimentation a changé. - PBT _ APMRESUMEAUTOMATIC
- 18 (0x12)
L’opération reprend automatiquement à partir d’un état de faible consommation d’énergie. Ce message est envoyé à chaque reprise du système. - PBT _ APMRESUMESUSPEND
- 7 (0x7)
L’opération reprend à partir d’un état de faible consommation d’énergie. Ce message est envoyé après PBT _ APMRESUMEAUTOMATIC si la reprise est déclenchée par une entrée utilisateur, par exemple en appuyant sur une touche. - PBT _ APMSUSPEND
- 4 (0x4)
Le système interrompt l’opération. - PBT _ POWERSETTINGCHANGE
- 32787 (0x8013)
Un événement de modification du paramètre d’alimentation a été reçu. -
lParam
-
Données spécifiques à l’événement. Pour la plupart des événements, ce paramètre est réservé et n’est pas utilisé.
Si le paramètre wParam est PBT _ POWERSETTINGCHANGE, le paramètre lParam est un pointeur vers une structure de _ paramètre POWERBROADCAST .
Valeur de retour
Une application doit retourner la valeur true si elle traite ce message.
Notes
Le système envoie toujours un message PBT _ APMRESUMEAUTOMATIC à chaque reprise du système. Si le système reprend en réponse à une entrée utilisateur, par exemple en appuyant sur une touche, le système envoie également un message PBT _ APMRESUMESUSPEND après l’envoi de _ APMRESUMEAUTOMATIC PBT.
WM _ Les messages POWERBROADCAST ne font pas la distinction entre les différents États de faible consommation d’énergie. Une application peut déterminer uniquement que le système entre dans un état de faible consommation d’énergie. il ne peut pas déterminer l’état d’alimentation spécifique. le système enregistre des détails sur les transitions d’état d’alimentation dans le journal des événements système Windows.
pour empêcher le système de passer à un état de faible consommation d’énergie dans Windows Vista, une application doit appeler SetThreadExecutionState pour informer le système qu’elle est en cours d’utilisation.
Les messages suivants ne sont pas pris en charge sur les systèmes d’exploitation spécifiés dans la section Configuration requise :
- PBT_APMQUERYSTANDBY
- PBT_APMQUERYSTANDBYFAILED
- PBT_APMSTANDBY
- PBT_APMRESUMESTANDBY
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau XP uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2003 [ applications de bureau uniquement] |
| En-tête |
|