Funzione GetDevicePowerState (winbase.h)

Recupera lo stato di alimentazione corrente del dispositivo specificato. Questa funzione non può essere usata per eseguire query sullo stato di alimentazione di un dispositivo di visualizzazione.

Sintassi

BOOL GetDevicePowerState(
  [in]  HANDLE hDevice,
  [out] BOOL   *pfOn
);

Parametri

[in] hDevice

Handle per un oggetto nel dispositivo, ad esempio un file o un socket, o un handle per il dispositivo stesso.

[out] pfOn

Puntatore alla variabile che riceve lo stato di alimentazione. Questo valore è TRUE se il dispositivo è nello stato di lavoro. In caso contrario, è FALSE.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Un'applicazione può usare GetDevicePowerState per determinare se un dispositivo si trova nello stato di lavoro o in uno stato a basso consumo. Se il dispositivo è in stato a basso consumo, l'accesso al dispositivo può causare la coda o l'esito negativo di eventuali richieste di I/O oppure eseguire la transizione del dispositivo allo stato di lavoro. Il comportamento esatto dipende dall'implementazione del dispositivo.

Per garantire la massima durata della batteria in un computer portatile, usare GetDevicePowerState per ridurre il consumo di energia. Ad esempio, se un disco è attualmente spento, l'accesso al disco causerà l'attivazione, con conseguente aumento del consumo di energia e riduzione della durata della batteria.

Le applicazioni devono rinviare o limitare l'accesso ai dispositivi laddove possibile, mentre il sistema è in esecuzione sull'alimentazione a batteria. Per determinare se il sistema è in esecuzione sull'alimentazione a batteria e la durata rimanente della batteria, usare la funzione GetSystemPowerStatus .

Requisiti

Vedere anche

GetSystemPowerStatus

Funzioni di risparmio energia

Stato alimentazione sistema