Función PoFxRegisterCoreDevice (pepfx.h)

  • Artículo

La rutina PoFxRegisterCoreDevice registra un nuevo recurso de sistema principal con el marco de administración de energía de Windows (PoFx).

Sintaxis

NTSTATUS PoFxRegisterCoreDevice(
  [in]  PCUNICODE_STRING   Id,
  [in]  PPO_FX_CORE_DEVICE Device,
  [out] POHANDLE           *Handle
);

Parámetros

[in] Id

Cadena que identifica de forma única el recurso del sistema principal. Este miembro es un puntero a una estructura de UNICODE_STRING que contiene una cadena de identificación del dispositivo.

[in] Device

Puntero a una estructura de PO_FX_CORE_DEVICE que describe las características de potencia del recurso del sistema principal.

[out] Handle

Puntero a una ubicación en la que la rutina escribe un valor POHANDLE. Este identificador representa el registro del recurso del sistema principal con PoFx.

Valor devuelto

PoFxRegisterCoreDevice 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 número de componentes de este dispositivo es cero o la estructura de PO_FX_CORE_DEVICE contiene un número de versión no válido o el miembro ComponentCriticalTransitionCallback de esta estructura contiene un puntero de función no válido.
STATUS_INSUFFICIENT_RESOURCES
 No se pueden asignar los recursos necesarios para completar el registro solicitado.

Comentarios

Esta rutina registra un recurso de sistema principal para que poFx pueda administrar este recurso con energía.

Los recursos principales del sistema son dispositivos de hardware, como temporizadores y controladores de interrupción, administrados por la capa de abstracción de hardware de Windows (HAL). Estos dispositivos proporcionan funciones básicas requeridas por el sistema operativo. Debido a la estrecha relación entre los recursos principales del sistema y los procesadores, la administración de energía de estos recursos debe coordinarse con la administración del estado inactivo del procesador.

Se debe llamar a la rutina PoFxRegisterCoreDevice 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

PO_FX_CORE_DEVICE

UNICODE_STRING