Função WriteProcessorPwrScheme (powrprof.h)

[WriteProcessorPwrScheme 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.]

Grava as configurações de política de energia do processador para o esquema de energia especificado.

Sintaxe

BOOLEAN WriteProcessorPwrScheme(
  [in] UINT                            uiID,
  [in] PMACHINE_PROCESSOR_POWER_POLICY pMachineProcessorPowerPolicy
);

Parâmetros

[in] uiID

O índice do esquema de energia a ser gravado.

[in] pMachineProcessorPowerPolicy

Um ponteiro para uma estrutura MACHINE_PROCESSOR_POWER_POLICY que contém as configurações de política de energia a serem gravadas.

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 alteração não afeta a política de energia do sistema atual. Para aplicar essa alteração à política de energia do sistema atual, chame a função SetActivePwrScheme usando o índice desse esquema de energia.

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

ReadProcessorPwrScheme