Función PoFxRegisterPluginEx (pepfx.h)

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

Sintaxis

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

Parámetros

[in] PepInformation

Puntero a una estructura de PEP_INFORMATION que contiene punteros a una o varias rutinas de devolución de llamada implementadas por el PEP. Estas rutinas controlan las notificaciones enviadas al PEP por PoFx.

[in] Flags

Conjunto de bits de marca para configurar la interfaz PEP. Establezca este miembro en cero o en el valor siguiente.

Bit de marca Descripción
PEP_FLAG_WORKER_CONCURRENCY

[in, out] KernelInformation

Puntero a una estructura de PEP_KERNEL_INFORMATION .

Valor devuelto

PoFxRegisterPluginEx 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 PoFxRegisterPlugin es similar a PoFxRegisterPluginEx, salvo que no toma un parámetro Flags .

El PEP debe llamar a PoFxRegisterPluginEx 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

PoFxRegisterPlugin