PEP_KERNEL_INFORMATION_STRUCT_V3 Struktur (pepfx.h)

Die PEP_KERNEL_INFORMATION_STRUCT_V3 Struktur gibt die Schnittstelle an, die das Power Extension Plug-In (PEP) zum Anfordern von Diensten aus dem Windows Power Management Framework (PoFx) verwendet.

Syntax

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;

Member

Version

Die aktuelle Versionsnummer für diese Struktur. Legen Sie dieses Element auf PEP_KERNEL_INFORMATION_VERSION fest.

Size

Die Größe (in Bytes) dieser Struktur. Legen Sie dieses Element auf sizeof(PEP_KERNEL_INFORMATION) fest.

Plugin

Das Handle, das der Registrierung von PEP bei PoFx zugewiesen wurde. PoFx legt den Wert dieses Elements fest. Der PEP verwendet diesen Handle in Anrufen an die RequestWorker-Routine .

RequestWorker

Ein Zeiger auf eine RequestWorker-Routine . PoFx legt den Wert dieses Elements fest. Die RequestWorker-Routine wird von PoFx implementiert. Die PEP ruft diese Routine auf, um die Verwendung eines Workerthreads aus dem Betriebssystem anzufordern.

EnumerateUnmaskedInterrupts

Ein Zeiger auf eine EnumerateUnmaskedInterrupts-Routine . PoFx legt den Wert dieses Elements fest. Die EnumerateUnmaskedInterrupts-Routine wird von PoFx implementiert. Die PEP ruft diese Routine auf, um Informationen über die ungemasketen Unterbrechungen anzufordern.

ProcessorHalt

Ein Zeiger auf eine ProcessorHalt-Routine . PoFx legt den Wert dieses Elements fest. Die ProcessorHalt-Routine wird von PoFx implementiert. Die PEP ruft diese Routine auf, um den aktuellen Prozessor auf den angehaltenen Zustand vorzubereiten.

RequestInterrupt

Ein Zeiger auf eine RequestInterrupt-Routine . PoFx legt den Wert dieses Elements fest. Die RequestInterrupt-Routine wird von PoFx implementiert. Die PEP ruft diese Routine auf, um eine edgeauslöste Unterbrechung wiederzugeben, die möglicherweise verloren gegangen ist, nachdem die Hardwareplattform einen Systemzustand mit niedriger Leistung eingegeben hat.

TransitionCriticalResource

Ein Zeiger auf eine TransitionCriticalResource-Routine . PoFx legt den Wert dieses Elements fest. Die TransitionCriticalResource-Routine wird von PoFx implementiert. Die PEP ruft diese Routine auf, um kritische Systemressourcen in den Leerlaufzustand zu übertragen.

ProcessorIdleVeto

Ein Zeiger auf eine ProcessorIdleVeto-Routine . PoFx legt den Wert dieses Elements fest. Die ProcessorIdleVeto-Routine wird von PoFx implementiert. Die PEP ruft diese Routine auf, um die Vetoanzahl für einen ausstehenden Übergang zu einem Prozessor-Leerlaufzustand zu erhöhen oder zu verringern.

PlatformIdleVeto

Ein Zeiger auf eine PlatformIdleVeto-Routine . PoFx legt den Wert dieses Elements fest. Die PlatformIdleVeto-Routine wird von PoFx implementiert. Die PEP ruft diese Routine auf, um die Vetoanzahl für einen ausstehenden Übergang zu einem Plattform-Leerlaufstatus zu erhöhen oder zu verringern.

UpdateProcessorIdleState

Ein Zeiger auf eine UpdateProcessorIdleState-Routine . PoFx legt den Wert dieses Elements fest. Die UpdateProcessorIdleState-Routine wird von PoFx implementiert. Die PEP ruft diese Routine auf, um die Eigenschaften des angegebenen Prozessor-Leerlaufzustands zu aktualisieren.

UpdatePlatformIdleState

Ein Zeiger auf eine UpdatePlatformIdleState-Routine . PoFx legt den Wert dieses Elements fest. Die UpdatePlatformIdleState-Routine wird von PoFx implementiert. Die PEP ruft diese Routine auf, um die Eigenschaften des angegebenen Plattform-Leerlaufzustands zu aktualisieren.

RequestCommon

Ein Zeiger auf eine RequestCommon-Routine . PoFx legt den Wert dieses Elements fest. Die RequestCommon-Routine wird von PoFx implementiert. Die PEP ruft diese Routine auf, um einen Verarbeitungsvorgang auszuführen, der durch eine Anforderungs-ID angegeben wird.

Bemerkungen

Der KernelInformation-Parameter auf die PoFxRegisterPlugin - oder PoFxRegisterPluginEx-Routine ist ein Zeiger auf eine PEP_KERNEL_INFORMATION-Struktur . Die PEP weist diese Struktur zu und legt die Werte der Elemente "Version " und "Größe " dieser Struktur fest, bevor PoFxRegisterPlugin oder PoFxRegisterPluginEx aufgerufen wird. Während des Aufrufs dieser Routine füllt PoFx die verbleibenden Member der Struktur aus.

Requirements (Anforderungen)

   
Unterstützte Mindestversion (Client) Unterstützt ab Windows 10.
Header pepfx.h (include Pep_x.h)

Weitere Informationen

AufzählenUnmaskedInterrupts

PlatformIdleVeto

PoFxRegisterPlugin

PoFxRegisterPluginEx

ProzessorHalt

ProcessorIdleVeto

RequestCommon

RequestInterrupt

RequestWorker

TransitionCriticalResource

UpdatePlatformIdleState

UpdateProcessorIdleState