Función de devolución de llamada POFXCALLBACKUPDATEPROCESSORIDLESTATE (pep_x.h)

  • Artículo

El complemento de extensión de plataforma (PEP) llama a la rutina UpdateProcessorIdleState para actualizar las propiedades del estado inactivo del procesador especificado.

Sintaxis

POFXCALLBACKUPDATEPROCESSORIDLESTATE Pofxcallbackupdateprocessoridlestate;

NTSTATUS Pofxcallbackupdateprocessoridlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG ProcessorState,
  [in] PPEP_PROCESSOR_IDLE_STATE_UPDATE Update
)
{...}

Parámetros

[in] ProcessorHandle

Valor POHANDLE que representa el registro del procesador (como dispositivo) con el marco de administración de energía de Windows (PoFx). El PEP recibió previamente este identificador de PoFx durante la notificación de PEP_DPM_REGISTER_DEVICE que informó al PEP de que el procesador se había registrado con PoFx.

[in] ProcessorState

Índice que identifica el estado inactivo del procesador cuyas propiedades se van a actualizar. En respuesta a una notificación anterior de PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2 , el PEP especificó el número de estados inactivos de procesador admitidos y las propiedades de estos estados. Si el PEP especificó N estados inactivos del procesador, los índices de estado de inactividad del procesador válidos oscilan entre 0 y N-1.

[in] Update

Puntero a una estructura PEP_PROCESSOR_IDLE_STATE_UPDATE que contiene las propiedades actualizadas del estado inactivo del procesador.

Valor devuelto

UpdateProcessorIdleState devuelve STATUS_SUCCESS si actualiza correctamente las propiedades del estado inactivo del procesador. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.

Valor devuelto Descripción
STATUS_NOT_SUPPORTED
 El número de versión de la estructura PEP_PROCESSOR_IDLE_STATE_UPDATE no es un valor admitido.
STATUS_NOT_IMPLEMENTED
 La rutina UpdateProcessorIdleState no se implementa para este procesador.

Comentarios

PoFx implementa esta rutina y la llama el PEP. El miembro UpdateProcessorIdleState de la estructura PEP_KERNEL_INFORMATION_STRUCT_V3 es un puntero a una rutina UpdateProcessorIdleState .

Se debe llamar a la rutina UpdateProcessorIdleState en IRQL = PASSIVE_LEVEL.

Requisitos

Requisito Value
Cliente mínimo compatible Se admite a partir de Windows 10.
Plataforma de destino Windows
Encabezado pep_x.h (incluya Pep_x.h)
IRQL PASSIVE_LEVEL

Consulte también

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE