Função PoFxRegisterPlugin (pepfx.h)
A rotina PoFxRegisterPlugin registra um PEP (plug-in de extensão de plataforma) com a estrutura de gerenciamento de energia do Windows (PoFx).
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.
Valor de retorno
PoFxRegisterPlugin 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 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 |
|---|---|
| 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 |