Función PoFxRegisterPlugin (pepfx.h)

  • Artículo

La rutina PoFxRegisterPlugin registra un complemento de extensión de plataforma (PEP) con el marco de administración de energía de Windows (PoFx).

Sintaxis

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

Parámetros

[in] PepInformation

Puntero a una estructura de PEP_INFORMATION .

[in, out] KernelInformation

Puntero a una estructura de PEP_KERNEL_INFORMATION_STRUCT_V3 .

Valor devuelto

PoFxRegisterPlugin devuelve STATUS_SUCCESS si la llamada registra correctamente el PEP. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.

Valor devuelto Descripción
STATUS_INVALID_PARAMETER El miembro Version o Size de la estructura PEP_KERNEL_INFORMATION se establece en un valor no válido; o el miembro AcceptDeviceNotification de esta estructura se establece en NULL.
STATUS_INVALID_PEP_INFO_VERSION El miembro Version de la estructura PEP_INFORMATION se establece en un valor no válido.
STATUS_INSUFFICIENT_RESOURCES No se pueden asignar los recursos necesarios para completar el registro solicitado.

Comentarios

Un PEP llama a esta rutina para registrarse en PoFx.

Un PEP no puede anular el registro y no se puede registrar dos veces. Si se debe atender el PEP, el sistema operativo debe reiniciarse.

La rutina PoFxRegisterPluginEx es similar a PoFxRegisterPlugin, salvo que toma un parámetro adicional, Flags.

El PEP debe llamar a PoFxRegisterPlugin en IRQL = PASSIVE_LEVEL.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 10.
Plataforma de destino Windows
Encabezado pepfx.h (include Pep_x.h)
Library Ntoskrnl.lib
IRQL PASSIVE_LEVEL

Consulte también

PEP_INFORMATION

PEP_KERNEL_INFORMATION_STRUCT_V3

PoFxRegisterPluginEx