Função GetPwrCapabilities (powerbase.h)
Recupera informações sobre os recursos de energia do sistema.
Sintaxe
BOOLEAN GetPwrCapabilities(
[out] PSYSTEM_POWER_CAPABILITIES lpspc
);
Parâmetros
[out] lpspc
Um ponteiro para uma estrutura SYSTEM_POWER_CAPABILITIES que recebe as informações.
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. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Essa função recupera informações detalhadas sobre os recursos e funcionalidades atuais de hardware de gerenciamento de energia do sistema. Isso inclui informações sobre a presença de recursos de hardware, como botões de energia, comutadores de tampa e baterias. Outros detalhes retornados incluem informações sobre as funcionalidades e configurações atuais de gerenciamento de energia que podem ser alteradas dinamicamente, como o estado mínimo de suspensão com suporte no momento, que pode mudar à medida que novos drivers são introduzidos no sistema ou a presença do arquivo de hibernação do sistema.
Essas informações também estão disponíveis por meio da função CallNtPowerInformation , usando o nível SystemPowerCapabilities.
Para obter mais informações sobre como usar PowrProf.h, consulte Power Schemes.
Requisitos
| Requisito | Valor |
|---|---|
| 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 | powerbase.h |
| Biblioteca | PowrProf.lib |
| DLL | PowrProf.dll |