_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
WinUser. h (inclure Windows. h)

Voir aussi

_Messages WM POWERBROADCAST

Messages de gestion de l’alimentation