WM_POWER message

Avertit les applications que le système, généralement un ordinateur personnel alimenté par batterie, est sur le point d’entrer en mode suspendu.

Une fenêtre reçoit ce message via sa fonction WindowProc .

LRESULT CALLBACK WindowProc
  HWND   hwnd,    // handle to window
  UINT   uMsg,    // WM_POWER
  WPARAM wParam,  // power-event notification
  LPARAM lParam   // not used
); 

Paramètres

Hwnd

Handle to window.

uMsg

Identificateur de message WM_POWER .

wParam

Notification power-event. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
PWR_CRITICALRESUME	Indique que le système reprend l’opération après avoir entré en mode suspendu sans avoir d’abord diffusé un message de notification PWR_SUSPENDREQUEST à l’application. Une application doit effectuer toutes les actions de récupération nécessaires.
PWR_SUSPENDREQUEST	Indique que le système est sur le point d’entrer en mode suspendu.
PWR_SUSPENDRESUME	Indique que le système reprend le fonctionnement après avoir entré normalement le mode suspendu, c’est-à-dire que le système a diffusé un message de notification PWR_SUSPENDREQUEST à l’application avant la suspension du système. Une application doit effectuer toutes les actions de récupération nécessaires.

lParam

Ce paramètre n'est pas utilisé.

Valeur retournée

La valeur renvoyée par une application dépend de la valeur du paramètre wParam . Si wParam est PWR_SUSPENDREQUEST, la valeur de retour est PWR_FAIL pour empêcher le système d’entrer l’état suspendu ; sinon, c’est PWR_OK. Si wParam est PWR_SUSPENDRESUME ou PWR_CRITICALRESUME, la valeur de retour est zéro.

Notes

Ce message est diffusé uniquement vers une application qui s’exécute sur un système conforme à la spécification du système d’entrée/sortie (BIOS) de base de la gestion de l’alimentation (APM). Le message est diffusé par le pilote de gestion de l’alimentation dans chaque fenêtre retournée par la fonction EnumWindows .

Le mode suspendu est l’état dans lequel les économies d’énergie les plus importantes se produisent, mais toutes les données et paramètres opérationnels sont conservés. Le contenu de la mémoire à accès aléatoire (RAM) est conservé, mais de nombreux appareils sont susceptibles d’être désactivés.

Spécifications

Voir aussi

WM_POWERBROADCAST