struttura PEP_KERNEL_INFORMATION_STRUCT_V3 (pepfx.h)

Articolo
03/05/2024

La struttura PEP_KERNEL_INFORMATION_STRUCT_V3 specifica l'interfaccia usata dal plug-in di estensione alimentazione (PEP) per richiedere servizi dal framework di risparmio energia di Windows (PoFx).

Sintassi

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;

Members

Version

Numero di versione corrente per questa struttura. Impostare questo membro su PEP_KERNEL_INFORMATION_VERSION.

Size

Dimensione, in byte, della struttura. Impostare questo membro su sizeof(PEP_KERNEL_INFORMATION).

Plugin

Handle assegnato alla registrazione del PEP con PoFx. PoFx imposta il valore di questo membro. Il PEP usa questo handle nelle chiamate alla routine RequestWorker .

RequestWorker

Puntatore a una routine RequestWorker . PoFx imposta il valore di questo membro. La routine RequestWorker viene implementata da PoFx. Il PEP chiama questa routine per richiedere l'uso di un thread di lavoro dal sistema operativo.

EnumerateUnmaskedInterrupts

Puntatore a una routine EnumerateUnmaskedInterrupts . PoFx imposta il valore di questo membro. La routine EnumerateUnmaskedInterrupts viene implementata da PoFx. Il PEP chiama questa routine per richiedere informazioni sugli interrupt non mascherati.

ProcessorHalt

Puntatore a una routine ProcessorHalt . PoFx imposta il valore di questo membro. La routine ProcessorHalt viene implementata da PoFx. Il PEP chiama questa routine per preparare il processore corrente per entrare nello stato interrotto.

RequestInterrupt

Puntatore a una routine RequestInterrupt . PoFx imposta il valore di questo membro. La routine RequestInterrupt viene implementata da PoFx. Il PEP chiama questa routine per riprodurre un interrupt attivato da edge che potrebbe essere stato perso dopo che la piattaforma hardware ha immesso uno stato di sistema a basso consumo.

TransitionCriticalResource

Puntatore a una routine TransitionCriticalResource . PoFx imposta il valore di questo membro. La routine TransitionCriticalResource viene implementata da PoFx. Il PEP chiama questa routine per passare le risorse di sistema critiche alla condizione di inattività.

ProcessorIdleVeto

Puntatore a una routine ProcessorIdleVeto . PoFx imposta il valore di questo membro. La routine ProcessorIdleVeto viene implementata da PoFx. Il PEP chiama questa routine per incrementare o decrementare il conteggio dei veto per una transizione in sospeso a uno stato di inattività del processore.

PlatformIdleVeto

Puntatore a una routine PlatformIdleVeto . PoFx imposta il valore di questo membro. La routine PlatformIdleVeto viene implementata da PoFx. Il PEP chiama questa routine per incrementare o decrementare il conteggio dei veto per una transizione in sospeso a uno stato di inattività della piattaforma.

UpdateProcessorIdleState

Puntatore a una routine UpdateProcessorIdleState . PoFx imposta il valore di questo membro. La routine UpdateProcessorIdleState viene implementata da PoFx. Il PEP chiama questa routine per aggiornare le proprietà dello stato di inattività del processore specificato.

UpdatePlatformIdleState

Puntatore a una routine UpdatePlatformIdleState . PoFx imposta il valore di questo membro. La routine UpdatePlatformIdleState viene implementata da PoFx. Il PEP chiama questa routine per aggiornare le proprietà dello stato di inattività della piattaforma specificato.

RequestCommon

Puntatore a una routine RequestCommon . PoFx imposta il valore di questo membro. La routine RequestCommon viene implementata da PoFx. Il PEP chiama questa routine per eseguire un'operazione di elaborazione specificata da un ID richiesta.

Commenti

Il parametro KernelInformation per la routine PoFxRegisterPlugin o PoFxRegisterPluginEx è un puntatore a una struttura PEP_KERNEL_INFORMATION . Il PEP alloca questa struttura e imposta i valori dei membri Version e Size di questa struttura prima di chiamare PoFxRegisterPlugin o PoFxRegisterPluginEx. Durante la chiamata a questa routine, PoFx riempie i membri rimanenti della struttura.