Função PoFxRegisterPluginEx (pep_x.h)

  • Artigo

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

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 PEP_INFORMATION que contém ponteiros para uma ou mais rotinas de retorno de chamada implementadas pelo PEP. Essas rotinas lidam com notificações enviadas para o PEP por 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 .

Retornar valor

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 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 no 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 PoFxRegisterPlugin é semelhante a PoFxRegisterPluginEx, exceto que não usa um parâmetro Flags .

O PEP deve chamar PoFxRegisterPluginEx 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 pep_x.h (inclua Pep_x.h)
Biblioteca Ntoskrnl.lib
IRQL PASSIVE_LEVEL

Confira também

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin