messaggio di WM_POWER

Notifica alle applicazioni che il sistema, in genere un personal computer alimentato a batteria, sta per entrare in una modalità sospesa.

Nota

Il messaggio di WM_POWER è obsoleto. Viene fornito solo per la compatibilità con le applicazioni basate su Windows a 16 bit. Le applicazioni devono usare il messaggio WM_POWERBROADCAST .

Una finestra riceve questo messaggio tramite la relativa funzione WindowProc .

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

Parametri

Hwnd

Handle per la finestra.

Umsg

Identificatore del messaggio WM_POWER .

wParam

Notifica dell'evento di alimentazione. Questo parametro può avere uno dei valori seguenti.

Valore Significato
PWR_CRITICALRESUME
Indica che il sistema riprende l'operazione dopo l'attivazione della modalità sospesa senza prima trasmettere un messaggio di notifica PWR_SUSPENDREQUEST all'applicazione. Un'applicazione deve eseguire le azioni di ripristino necessarie.
PWR_SUSPENDREQUEST
Indica che il sistema sta per entrare in modalità sospesa.
PWR_SUSPENDRESUME
Indica che il sistema riprende l'operazione dopo aver attivato la modalità di sospensione normalmente, ovvero il sistema trasmette un messaggio di notifica PWR_SUSPENDREQUEST all'applicazione prima della sospensione del sistema. Un'applicazione deve eseguire le azioni di ripristino necessarie.

lParam

Questo parametro non viene usato.

Valore restituito

Il valore restituito da un'applicazione dipende dal valore del parametro wParam . Se wParam è PWR_SUSPENDREQUEST, il valore restituito viene PWR_FAIL per impedire al sistema di entrare nello stato sospeso; in caso contrario, è PWR_OK. Se wParam è PWR_SUSPENDRESUME o PWR_CRITICALRESUME, il valore restituito è zero.

Commenti

Questo messaggio viene trasmesso solo a un'applicazione in esecuzione in un sistema conforme alla specifica bios (Advanced Power Management) di base del sistema di input/output( APM). Il messaggio viene trasmesso dal driver di risparmio energia a ogni finestra restituita dalla funzione EnumWindows .

La modalità sospesa è lo stato in cui si verifica la massima quantità di risparmio energia, ma vengono mantenuti tutti i dati operativi e i parametri. Il contenuto della memoria ad accesso casuale (RAM) viene mantenuto, ma è probabile che molti dispositivi vengano disattivati.

Requisiti

Requisito Valore
Client minimo supportato
Windows XP [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Intestazione
WinUser.h (include Windows.h)

Vedi anche

WM_POWERBROADCAST