Compartir a través de

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 siguiente valor.

Bit de marca Descripción
PEP_FLAG_WORKER_CONCURRENCY

[in, out] KernelInformation

Puntero a una estructura 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 versión de o miembro Size de la estructura de PEP_KERNEL_INFORMATION se establece en un valor no válido; o el AcceptDeviceNotification miembro de esta estructura se establece en NULL.
STATUS_INVALID_PEP_INFO_VERSION
 El miembro versión de de la estructura PEP_INFORMATION está establecido en un valor no válido.
STATUS_INSUFFICIENT_RESOURCES
 No se pueden asignar los recursos necesarios para completar el registro solicitado.

Observaciones

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, excepto que no toma un parámetro Flags.

El PEP debe llamar a PoFxRegisterPluginEx en IRQL = PASSIVE_LEVEL.

Requisitos

Requisito Valor
cliente mínimo admitido Disponible a partir de Windows 10.
de la plataforma de destino de Windows
encabezado de pepfx.h (include Pep_x.h)
biblioteca de Ntoskrnl.lib
irQL PASSIVE_LEVEL

Consulte también

PEP_INFORMATION

PEP_KERNEL_INFORMATION

poFxRegisterPlugin

  • Last updated on