Fonction de rappel POFXCALLBACKUPDATEPROCESSORIDLESTATE (pepfx.h)

  • Article

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 déjà reçu ce handle de PoFx lors de la PEP_DPM_REGISTER_DEVICE notification qui l’a informé que le sous-traitant avait été enregistré 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 d’inactivité du processeur pris en charge et les propriétés de ces états. Si le PEP a spécifié N états d’inactivité du processeur, les index d’état d’inactivité du processeur valides varient de 0 à N-1.

[in] Update

Pointeur vers une structure de 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 à jour correctement 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 à l’adresse 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 pepfx.h (include Pep_x.h)
IRQL PASSIVE_LEVEL

Voir aussi

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE