Lire en anglais

Partager via


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.

Notes

Le message WM_POWER est obsolète. Il est fourni uniquement pour la compatibilité avec les applications Windows 16 bits. Les applications doivent utiliser le message WM_POWERBROADCAST .

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

Condition requise Valeur
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 (inclure Windows.h)

Voir aussi

WM_POWERBROADCAST