Fonction de rappel POFXCALLBACKUPDATEPROCESSORIDLESTATE (pep_x.h)

Article
02/29/2024

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) auprès de l’infrastructure de gestion de l’alimentation Windows (PoFx). Le PEP a précédemment reçu ce handle de PoFx lors de la notification PEP_DPM_REGISTER_DEVICE qui l’a informé que le processeur avait été inscrit auprès de PoFx.

[in] ProcessorState

Index qui identifie l’état d’inactivité 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 d’inactivité du processeur pris en charge et les propriétés de ces états. Si le PEP spécifié N états d’inactivité du processeur, les index d’état d’inactivité du processeur valides vont de 0 à N-1.

[in] Update

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

Valeur retournée

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

Valeur retournée	Description
STATUS_NOT_SUPPORTED	Le numéro de version dans 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 dans IRQL = PASSIVE_LEVEL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge à partir de Windows 10.
Plateforme cible	Windows
En-tête	pep_x.h (include Pep_x.h)
IRQL	PASSIVE_LEVEL

Voir aussi

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE

Partager via