structure PEP_KERNEL_INFORMATION_STRUCT_V3 (pepfx.h)

Article
03/01/2024

La structure PEP_KERNEL_INFORMATION_STRUCT_V3 spécifie l’interface que le plug-in d’extension d’alimentation (PEP) utilise pour demander des services à partir de l’infrastructure de gestion de l’alimentation Windows (PoFx).

Syntaxe

typedef struct _PEP_KERNEL_INFORMATION_STRUCT_V3 {
  USHORT                                   Version;
  USHORT                                   Size;
  POHANDLE                                 Plugin;
  PPOFXCALLBACKREQUESTWORKER               RequestWorker;
  PPOFXCALLBACKENUMERATEUNMASKEDINTERRUPTS EnumerateUnmaskedInterrupts;
  PPOFXCALLBACKPROCESSORHALT               ProcessorHalt;
  PPOFXCALLBACKREQUESTINTERRUPT            RequestInterrupt;
  PPOFXCALLBACKCRITICALRESOURCE            TransitionCriticalResource;
  PPOFXCALLBACKPROCESSORIDLEVETO           ProcessorIdleVeto;
  PPOFXCALLBACKPLATFORMIDLEVETO            PlatformIdleVeto;
  PPOFXCALLBACKUPDATEPROCESSORIDLESTATE    UpdateProcessorIdleState;
  PPOFXCALLBACKUPDATEPLATFORMIDLESTATE     UpdatePlatformIdleState;
  PPOFXCALLBACKREQUESTCOMMON               RequestCommon;
} PEP_KERNEL_INFORMATION_STRUCT_V3, *PPEP_KERNEL_INFORMATION_STRUCT_V3;

Membres

Version

Numéro de version actuel de cette structure. Définissez ce membre sur PEP_KERNEL_INFORMATION_VERSION.

Size

Taille, en octets, de cette structure. Définissez ce membre sur sizeof(PEP_KERNEL_INFORMATION).

Plugin

Handle affecté à l’inscription du PEP auprès de PoFx. PoFx définit la valeur de ce membre. Le PEP utilise ce handle dans les appels à la routine RequestWorker .

RequestWorker

Pointeur vers une routine RequestWorker . PoFx définit la valeur de ce membre. La routine RequestWorker est implémentée par PoFx. Le PEP appelle cette routine pour demander l’utilisation d’un thread worker à partir du système d’exploitation.

EnumerateUnmaskedInterrupts

Pointeur vers une routine EnumerateUnmaskedInterrupts . PoFx définit la valeur de ce membre. La routine EnumerateUnmaskedInterrupts est implémentée par PoFx. Le PEP appelle cette routine pour demander des informations sur les interruptions masquées.

ProcessorHalt

Pointeur vers une routine ProcessorHalt . PoFx définit la valeur de ce membre. La routine ProcessorHalt est implémentée par PoFx. Le PEP appelle cette routine pour préparer le processeur actuel à entrer dans l’état arrêté.

RequestInterrupt

Pointeur vers une routine RequestInterrupt . PoFx définit la valeur de ce membre. La routine RequestInterrupt est implémentée par PoFx. Le PEP appelle cette routine pour relire une interruption déclenchée par le bord qui pourrait avoir été perdue après l’entrée de la plateforme matérielle dans un état de système à faible consommation d’énergie.

TransitionCriticalResource

Pointeur vers une routine TransitionCriticalResource . PoFx définit la valeur de ce membre. La routine TransitionCriticalResource est implémentée par PoFx. Le PEP appelle cette routine pour faire passer les ressources système critiques à la condition inactive.

ProcessorIdleVeto

Pointeur vers une routine ProcessorIdleVeto . PoFx définit la valeur de ce membre. La routine ProcessorIdleVeto est implémentée par PoFx. Le PEP appelle cette routine pour incrémenter ou décrémenter le nombre de vetos pour une transition en attente vers un état d’inactivité du processeur.

PlatformIdleVeto

Pointeur vers une routine PlatformIdleVeto . PoFx définit la valeur de ce membre. La routine PlatformIdleVeto est implémentée par PoFx. Le PEP appelle cette routine pour incrémenter ou décrémenter le nombre de vetos pour une transition en attente vers un état inactif de plateforme.

UpdateProcessorIdleState

Pointeur vers une routine UpdateProcessorIdleState . PoFx définit la valeur de ce membre. La routine UpdateProcessorIdleState est implémentée par PoFx. Le PEP appelle cette routine pour mettre à jour les propriétés de l’état d’inactivité du processeur spécifié.

UpdatePlatformIdleState

Pointeur vers une routine UpdatePlatformIdleState . PoFx définit la valeur de ce membre. La routine UpdatePlatformIdleState est implémentée par PoFx. Le PEP appelle cette routine pour mettre à jour les propriétés de l’état d’inactivité de la plateforme spécifié.

RequestCommon

Pointeur vers une routine RequestCommon . PoFx définit la valeur de ce membre. La routine RequestCommon est implémentée par PoFx. Le PEP appelle cette routine pour effectuer une opération de traitement spécifiée par un ID de demande.

Remarques

Le paramètre KernelInformation vers la routine PoFxRegisterPlugin ou PoFxRegisterPluginEx est un pointeur vers une structure PEP_KERNEL_INFORMATION . Le PEP alloue cette structure et définit les valeurs des membres Version et Size de cette structure avant d’appeler PoFxRegisterPlugin ou PoFxRegisterPluginEx. Pendant l’appel à cette routine, PoFx remplit les membres restants de la structure.