Función de devolución de llamada POFXCALLBACKUPDATEPLATFORMIDLESTATE (pepfx.h)
El complemento de extensión de plataforma (PEP) llama a la rutina UpdatePlatformIdleState para actualizar las propiedades del estado inactivo de la plataforma especificada.
Sintaxis
POFXCALLBACKUPDATEPLATFORMIDLESTATE Pofxcallbackupdateplatformidlestate;
NTSTATUS Pofxcallbackupdateplatformidlestate(
[in] POHANDLE ProcessorHandle,
[in] ULONG PlatformState,
[in] PPEP_PLATFORM_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] PlatformState
Índice que identifica el estado inactivo de la plataforma cuyas propiedades se van a actualizar. En respuesta a una notificación anterior de PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES , el PEP especificó el número de estados inactivos de plataforma admitidos. Si el PEP especificó N estados inactivos de la plataforma, los índices de estado de inactividad de la plataforma válidos oscilan entre 0 y N-1. En respuesta a una notificación de PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE anterior, el PEP especificó las propiedades de este estado inactivo de la plataforma.
[in] Update
Puntero a una estructura de PEP_PLATFORM_IDLE_STATE_UPDATE que contiene las propiedades actualizadas del estado inactivo de la plataforma.
Valor devuelto
UpdatePlatformIdleState devuelve STATUS_SUCCESS si actualiza correctamente las propiedades del estado inactivo de la plataforma. 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_PLATFORM_IDLE_STATE_UPDATE no es un valor admitido. |
|
La rutina UpdatePlatformIdleState no se implementa para este procesador. |
Comentarios
PoFx implementa esta rutina y la llama el PEP. El miembro UpdatePlatformIdleState de la estructura PEP_KERNEL_INFORMATION_STRUCT_V3 es un puntero a una rutina UpdatePlatformIdleState .
El PEP debe esperar hasta que haya completado todas las notificaciones de PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE para llamar a la rutina UpdatePlatformIdleState .
Se debe llamar a la rutina UpdatePlatformIdleState en IRQL = PASSIVE_LEVEL.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite a partir de Windows 10. |
| Plataforma de destino | Windows |
| Encabezado | pepfx.h (include Pep_x.h) |
| IRQL | PASSIVE_LEVEL |
Consulte también
PEP_KERNEL_INFORMATION_STRUCT_V3
PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE