Função PoFxRegisterPluginEx (pepfx.h)

Artigo
02/07/2025

A rotina de PoFxRegisterPluginEx registra um PEP (plug-in de extensão de plataforma) com a poFx (estrutura de gerenciamento de energia) do Windows (PoFx).

Sintaxe

NTSTATUS PoFxRegisterPluginEx(
  [in]      PPEP_INFORMATION        PepInformation,
  [in]      ULONGLONG               Flags,
  [in, out] PPEP_KERNEL_INFORMATION KernelInformation
);

Parâmetros

[in] PepInformation

Um ponteiro para uma estrutura de PEP_INFORMATION que contém ponteiros para uma ou mais rotinas de retorno de chamada que são implementadas pelo PEP. Essas rotinas lidam com notificações enviadas ao PEP pela PoFx.

[in] Flags

Um conjunto de bits de sinalizador para configurar a interface PEP. Defina esse membro como zero ou com o valor a seguir.

Bit de sinalizador	Descrição
PEP_FLAG_WORKER_CONCURRENCY

[in, out] KernelInformation

Um ponteiro para uma estrutura PEP_KERNEL_INFORMATION.

Valor de retorno

PoFxRegisterPluginEx retornará STATUS_SUCCESS se a chamada registrar com êxito o PEP. Os valores de retorno de erro possíveis incluem os seguintes códigos de status.

Valor de retorno	Descrição
STATUS_INVALID_PARAMETER	O de Versão ou Membro do tamanho da estrutura PEP_KERNEL_INFORMATION é definido como um valor inválido; ou o AcceptDeviceNotification membro dessa estrutura é definido como NULL.
STATUS_INVALID_PEP_INFO_VERSION	O membro versão da estrutura PEP_INFORMATION é definido como um valor inválido.
STATUS_INSUFFICIENT_RESOURCES	Não é possível alocar os recursos necessários para concluir o registro solicitado.

Observações

Um PEP chama essa rotina para se registrar na PoFx.

Um PEP não pode cancelar o registro e não pode se registrar duas vezes. Se o PEP precisar ser atendido, o sistema operacional deverá ser reiniciado.

A rotina de PoFxRegisterPlugin é semelhante a PoFxRegisterPluginEx, exceto por não usar um parâmetro Flags.

O PEP deve chamar PoFxRegisterPluginEx em IRQL = PASSIVE_LEVEL.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 10.
da Plataforma de Destino	Windows
cabeçalho	pepfx.h (inclua Pep_x.h)
biblioteca	Ntoskrnl.lib
IRQL	PASSIVE_LEVEL

Consulte também

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin

Partilhar via