Freigeben über


PEP_KERNEL_INFORMATION_STRUCT_V3 Struktur (pep_x.h)

Die PEP_KERNEL_INFORMATION-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;

Angehörige

Version

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

Size

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

Plugin

Das Handle, das der PEP-Registrierung bei PoFx zugewiesen wurde. PoFx legt den Wert dieses Elements fest. Der PEP verwendet dieses 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 Arbeitsthreads vom 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 einen edgeauslösten Interrupt wiederzugeben, der möglicherweise verloren gegangen ist, nachdem die Hardwareplattform in einen Systemzustand mit niedriger Leistung gelangt ist.

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, 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 Leerlaufzustand des Prozessors 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-Leerlaufzustand 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 PoFxRegisterPlugin Ex-Routine ist ein Zeiger auf eine PEP_KERNEL_INFORMATION Struktur. Die PEP weist diese Struktur zu und legt die Werte der Version und Size Member dieser Struktur fest, bevor sie PoFxRegisterPlugin oder PoFxRegisterPluginExaufrufen. Während des Aufrufs dieser Routine füllt PoFx die verbleibenden Elemente der Struktur aus.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Wird ab Windows 10 unterstützt.
Header- pep_x.h

Siehe auch