Função PowerRegisterForEffectivePowerModeNotifications (powersetting.h)

Registra um retorno de chamada para receber notificações de alteração efetivas do modo de energia.

Sintaxe

HRESULT PowerRegisterForEffectivePowerModeNotifications(
  ULONG                         Version,
  EFFECTIVE_POWER_MODE_CALLBACK *Callback,
  PVOID                         Context,
  PVOID                         *RegistrationHandle
);

Parâmetros

Version

Fornece a versão máxima efetiva do modo de energia que o chamador entende. Se o modo de energia efetivo vier de uma versão posterior, ele será reduzido para uma versão compatível que, em seguida, é passada para o retorno de chamada.

Os seguintes valores podem ser passados:

• EFFECTIVE_POWER_MODE_V1 está disponível a partir do Windows 10, versão 1809 e controla os estados de controle deslizante de energia de desempenho e economia de bateria.
• EFFECTIVE_POWER_MODE_V2 está disponível a partir do Windows 10, versão 1903 e acompanha o controle deslizante de energia de desempenho, economia de bateria, modo de jogo e estados de energia de realidade misturada do Windows.

Callback

Um ponteiro para o retorno de chamada a ser chamado quando o modo de energia efetivo for alterado. Isso também será chamado uma vez após o registro para fornecer o modo atual. Se vários retornos de chamada forem registrados usando essa API, esses retornos de chamada poderão ser chamados simultaneamente.

Context

Contexto opaco especificado pelo chamador.

RegistrationHandle

Um identificador para o registro. Use esse identificador para cancelar o registro de notificações.

Valor retornado

Retornará S_OK (zero) se a chamada tiver sido bem-sucedida e um valor diferente de zero se a chamada falhar.

Comentários

Imediatamente após o registro, o retorno de chamada será invocado com o valor atual da configuração de energia. Se o registro ocorrer enquanto o modo de energia estiver sendo alterado, você poderá receber vários retornos de chamada; o último retorno de chamada é a atualização mais recente.

Requisitos