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

Funções de gerenciamento de energia

Esquemas de energia

WriteProcessorPwrScheme