Función de devolución de llamada POFXCALLBACKUPDATEPROCESSORIDLESTATE (pep_x.h)
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ó 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 de PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2 anterior, el PEP especificó el número de estados inactivos del procesador admitidos y las propiedades de estos estados. Si el PEP especificado 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 de inactividad del procesador. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.
| Valor devuelto | Descripción |
|---|---|
|
El número de versión de la estructura PEP_PROCESSOR_IDLE_STATE_UPDATE no es un valor admitido. |
|
La rutina UpdateProcessorIdleState no se implementa para este procesador. |
Observaciones
PoFx implementa esta rutina y la llama el PEP. El miembro UpdateProcessorIdleState de de la estructura PEP_KERNEL_INFORMATION_STRUCT_V3 es un puntero a una rutina UpdateProcessorIdleState de.
La rutina UpdateProcessorIdleState debe llamarse en IRQL = PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Se admite a partir de Windows 10. |
| de la plataforma de destino de | Windows |
| encabezado de | pep_x.h (incluya Pep_x.h) |
| irQL | PASSIVE_LEVEL |