Fonction de rappel POFXCALLBACKUPDATEPROCESSORIDLESTATE (pep_x.h)

Article
02/07/2025

La routine UpdateProcessorIdleState est appelée par le plug-in d’extension de plateforme (PEP) pour mettre à jour les propriétés de l’état d’inactivité du processeur spécifié.

Syntaxe

POFXCALLBACKUPDATEPROCESSORIDLESTATE Pofxcallbackupdateprocessoridlestate;

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

Paramètres

[in] ProcessorHandle

Valeur POHANDLE qui représente l’inscription du processeur (en tant qu’appareil) avec l’infrastructure de gestion de l’alimentation Windows (PoFx). Le PEP a reçu précédemment ce handle de PoFx pendant la notification PEP_DPM_REGISTER_DEVICE qui a informé le PEP que le processeur avait été inscrit auprès de PoFx.

[in] ProcessorState

Index qui identifie l’état inactif du processeur dont les propriétés doivent être mises à jour. En réponse à une notification PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2 précédente, le PEP a spécifié le nombre d’états inactifs du processeur pris en charge et les propriétés de ces états. Si les états d’inactivité du processeur PEP spécifiés, les index d’état d’inactivité du processeur valides sont comprises entre 0 et N-1.

[in] Update

Pointeur vers une structure PEP_PROCESSOR_IDLE_STATE_UPDATE qui contient les propriétés mises à jour de l’état inactif du processeur.

Valeur de retour

UpdateProcessorIdleState retourne STATUS_SUCCESS si elle met à jour correctement les propriétés de l’état inactif du processeur. Les valeurs de retour d’erreur possibles incluent les codes d’état suivants.

Valeur de retour	Description
STATUS_NOT_SUPPORTED	Le numéro de version de la structure PEP_PROCESSOR_IDLE_STATE_UPDATE n’est pas une valeur prise en charge.
STATUS_NOT_IMPLEMENTED	La routine UpdateProcessorIdleState n’est pas implémentée pour ce processeur.

Remarques

Cette routine est implémentée par PoFx et est appelée par le PEP. Le membre UpdateProcessorIdleState de la structure PEP_KERNEL_INFORMATION_STRUCT_V3 est un pointeur vers une routine UpdateProcessorIdleState.

La routine UpdateProcessorIdleState doit être appelée à IRQL = PASSIVE_LEVEL.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge à partir de Windows 10.
plateforme cible	Windows
d’en-tête	pep_x.h (inclure Pep_x.h)
IRQL	PASSIVE_LEVEL

Voir aussi

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE

Partager via