Función de devolución de llamada POFXCALLBACKUPDATEPLATFORMIDLESTATE (pepfx.h)

  • Artículo

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
STATUS_NOT_SUPPORTED
 El número de versión de la estructura PEP_PLATFORM_IDLE_STATE_UPDATE no es un valor admitido.
STATUS_NOT_IMPLEMENTED
 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_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES

PEP_PLATFORM_IDLE_STATE_UPDATE