Função GetDevicePowerState (winbase.h)
Recupera o estado de energia atual do dispositivo especificado. Essa função não pode ser usada para consultar o estado de energia de um dispositivo de exibição.
Sintaxe
BOOL GetDevicePowerState(
[in] HANDLE hDevice,
[out] BOOL *pfOn
);
Parâmetros
[in] hDevice
Um identificador para um objeto no dispositivo, como um arquivo ou soquete, ou um identificador para o próprio dispositivo.
[out] pfOn
Um ponteiro para a variável que recebe o estado de energia. Esse valor será TRUE se o dispositivo estiver no estado de trabalho. Caso contrário, será FALSE.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero.
Comentários
Um aplicativo pode usar GetDevicePowerState para determinar se um dispositivo está no estado de trabalho ou em um estado de baixa potência. Se o dispositivo estiver em um estado de baixa potência, acessar o dispositivo poderá fazer com que ele faça fila ou falhe em solicitações de E/S ou faça a transição do dispositivo para o estado de trabalho. O comportamento exato depende da implementação do dispositivo.
Para garantir a duração máxima da bateria em um computador laptop, use GetDevicePowerState para reduzir o consumo de energia. Por exemplo, se um disco estiver desligado no momento, o acesso ao disco fará com que ele gire, resultando em maior consumo de energia e redução da duração da bateria.
Os aplicativos devem adiar ou limitar o acesso a dispositivos sempre que possível enquanto o sistema estiver em execução na energia da bateria. Para determinar se o sistema está em execução com a energia da bateria e a duração restante da bateria, use a função GetSystemPowerStatus .
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winbase.h (incluir Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |