Função PoRegisterForEffectivePowerModeNotifications (wdm.h)

A função PoRegisterForEffectivePowerModeNotifications registra um retorno de chamada para receber notificações de alteração efetivas do modo de energia.

Sintaxe

NTSTATUS PoRegisterForEffectivePowerModeNotifications(
  ULONG                             Version,
  PPO_EFFECTIVE_POWER_MODE_CALLBACK Callback,
  PVOID                             Context,
  PO_EPM_HANDLE                     *RegistrationHandle,
  PDEVICE_OBJECT                    DeviceObject
);

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á mapeado 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 acompanha os estados do controle deslizante de energia de desempenho e da economia de energia.

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

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, esses retornos de chamada poderão ser chamados simultaneamente.

Context

Contexto opaco especificado pelo chamador.

RegistrationHandle

Esse é um ponteiro para uma variável que recebe um identificador para o registro. Esse identificador pode ser usado para cancelar o registro da função de retorno de chamada.

DeviceObject

Esse é um parâmetro opcional que, se especificado, fornece um retorno de chamada registrado (como de um driver) com o contexto de dispositivo especificado.

Retornar valor

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

Requisito	Valor
Cliente mínimo com suporte	Windows 11, versão 24H2
Cabeçalho	wdm.h (include Wdm.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Confira também

PO_EFFECTIVE_POWER_MODE

PO_EFFECTIVE_POWER_MODE_CALLBACK

PoUnregisterFromEffectivePowerModeNotifications