structure PEP_KERNEL_INFORMATION_STRUCT_V2 (pep_x.h)
La structure PEP_KERNEL_INFORMATION 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_V2 {
USHORT Version;
USHORT Size;
POHANDLE Plugin;
PPOFXCALLBACKREQUESTWORKER RequestWorker;
PPOFXCALLBACKENUMERATEUNMASKEDINTERRUPTS EnumerateUnmaskedInterrupts;
PPOFXCALLBACKPROCESSORHALT ProcessorHalt;
PPOFXCALLBACKREQUESTINTERRUPT RequestInterrupt;
PPOFXCALLBACKCRITICALRESOURCE TransitionCriticalResource;
PPOFXCALLBACKPROCESSORIDLEVETO ProcessorIdleVeto;
PPOFXCALLBACKPLATFORMIDLEVETO PlatformIdleVeto;
PPOFXCALLBACKUPDATEPROCESSORIDLESTATE UpdateProcessorIdleState;
PPOFXCALLBACKUPDATEPLATFORMIDLESTATE UpdatePlatformIdleState;
} PEP_KERNEL_INFORMATION_STRUCT_V2, *PPEP_KERNEL_INFORMATION_STRUCT_V2;
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é.
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge à partir de Windows 10. |
| En-tête | pep_x.h |