Função ReadProcessorPwrScheme (powrprof.h)
[ReadProcessorPwrScheme está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Consulte Comentários.]
Recupera as configurações de política de energia do processador para o esquema de energia especificado.
Sintaxe
BOOLEAN ReadProcessorPwrScheme(
[in] UINT uiID,
[out] PMACHINE_PROCESSOR_POWER_POLICY pMachineProcessorPowerPolicy
);
Parâmetros
[in] uiID
O índice do esquema de energia a ser lido.
[out] pMachineProcessorPowerPolicy
Um ponteiro para uma estrutura MACHINE_PROCESSOR_POWER_POLICY que recebe as configurações de política de energia do processador.
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
A estrutura MACHINE_PROCESSOR_POWER_POLICY contém as configurações de política de energia do processador para uso enquanto o sistema está em execução com energia AC ou energia da bateria.
A partir do Windows Vista, a configuração de gerenciamento de energia do processador do sistema é controlada por meio do subgrupo GUID_PROCESSOR_SETTINGS_SUBGROUP configurações de energia. Use a função PowerEnumerate para enumerar configurações individuais.
Para obter mais informações sobre como usar PowrProf.h, consulte Esquemas de energia.
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 | powrprof.h |
| Biblioteca | PowrProf.lib |
| DLL | PowrProf.dll |
Confira também
MACHINE_PROCESSOR_POWER_POLICY