message WM_POWERBROADCAST

  • Article

Avertit les applications qu'un événement power-management s'est produit.

Une fenêtre reçoit ce message à travers 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 à fenêtre.

uMsg

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

wParam

Événement power-management. Ce paramètre peut être l’un des identificateurs d’événement suivants.

Événement Signification
PBT_APMPOWERSTATUSCHANGE
10 (0xA)
 L’état de l’alimentation change.
PBT_APMRESUMEAUTOMATIC
18 (0x12)
 L’opération reprend automatiquement après un état basse consommation. Ce message est envoyé chaque fois que le système reprend.
PBT_APMRESUMESUSPEND
7 (0x7)
 L’opération reprend après un état basse consommation. 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 suspend l’opération.
PBT_POWERSETTINGCHANGE
32787 (0x8013)
 Un événement de changement de 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 POWERBROADCAST_SETTING.

Valeur retournée

Si une application traite ce message, elle doit retourner TRUE.

Notes

Le système envoie toujours un message PBT_APMRESUMEAUTOMATIC chaque fois que le système reprend. 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 PBT_APMRESUMEAUTOMATIC.

Les messages WM_POWERBROADCAST ne changent pas en fonction des différents états basse consommation. L’application peut uniquement déterminer si le système entre dans un état de basse consommation ou reprend après cet état, elle 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 basse consommation dans Windows Vista, l’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 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 (y compris Windows.h)

Voir aussi