Função PoFxRegisterPlugin (pepfx.h)

  • Artigo

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

Sintaxe

NTSTATUS PoFxRegisterPlugin(
  [in]      PPEP_INFORMATION        PepInformation,
  [in, out] PPEP_KERNEL_INFORMATION KernelInformation
);

Parâmetros

[in] PepInformation

Um ponteiro para uma estrutura PEP_INFORMATION .

[in, out] KernelInformation

Um ponteiro para uma estrutura PEP_KERNEL_INFORMATION_STRUCT_V3 .

Retornar valor

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

Valor retornado Descrição
STATUS_INVALID_PARAMETER O membro Version ou Size da estrutura PEP_KERNEL_INFORMATION é definido como um valor inválido; ou o membro AcceptDeviceNotification dessa estrutura é definido como NULL.
STATUS_INVALID_PEP_INFO_VERSION O membro Version 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.

Comentários

Um PEP chama essa rotina para se registrar na PoFx.

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

A rotina PoFxRegisterPluginEx é semelhante a PoFxRegisterPlugin, exceto que ele usa um parâmetro adicional, Flags.

O PEP deve chamar PoFxRegisterPlugin em IRQL = PASSIVE_LEVEL.

Requisitos

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

Confira também

PEP_INFORMATION

PEP_KERNEL_INFORMATION_STRUCT_V3

PoFxRegisterPluginEx