structure PEP_KERNEL_INFORMATION_STRUCT_V3 (pepfx.h)

La structure PEP_KERNEL_INFORMATION_STRUCT_V3 spécifie l’interface utilisée par le plug-in d’extension d’alimentation (PEP) 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 point de terminaison privilégié 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 point de terminaison privilégié appelle cette routine pour demander l’utilisation d’un thread de travail à 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 point de terminaison privilégié appelle cette routine pour demander des informations sur les interruptions non 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 point de terminaison privilégié 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 point de terminaison privilégié appelle cette routine pour relire une interruption déclenchée par la périphérie qui a peut-être été perdue après que la plateforme matérielle a entré un état de système à faible alimentation.

TransitionCriticalResource

Pointeur vers une routine TransitionCriticalResource . PoFx définit la valeur de ce membre. La routine TransitionCriticalResource est implémentée par PoFx. Le point de terminaison privilégié appelle cette routine pour passer des 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 point de terminaison privilégié 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 veto 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 point de terminaison privilégié 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 point de terminaison privilégié appelle cette routine pour mettre à jour les propriétés de l’état inactif de la plateforme spécifiée.

RequestCommon

Pointeur vers une routine RequestCommon . PoFx définit la valeur de ce membre. La routine RequestCommon est implémentée par PoFx. Le point de terminaison privilégié appelle cette routine pour effectuer une opération de traitement spécifiée par un ID de requête.

Remarques

Le paramètre KernelInformation de 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

   
Client minimal pris en charge Prise en charge à partir de Windows 10.
En-tête pepfx.h (include Pep_x.h)

Voir aussi

EnumerateUnmaskedInterrupts

PlatformIdleVeto

PoFxRegisterPlugin

PoFxRegisterPluginEx

ProcessorHalt

ProcessorIdleVeto

RequestCommon

RequestInterrupt

RequestWorker

TransitionCriticalResource

UpdatePlatformIdleState

UpdateProcessorIdleState