PEP_KERNEL_INFORMATION_STRUCT_V2-Struktur (pep_x.h)

  • Artikel

Die PEP_KERNEL_INFORMATION-Struktur gibt die Schnittstelle an, die das Power Extension Plug-In (PEP) verwendet, um Dienste vom Windows Power Management Framework (PoFx) anzufordern.

Syntax

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;

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 diesen Member auf sizeof(PEP_KERNEL_INFORMATION) fest.

Plugin

Das Handle, das der Pep-Registrierung mit PoFx zugewiesen ist. PoFx legt den Wert dieses Members fest. Pep verwendet dieses Handle bei Aufrufen der RequestWorker-Routine .

RequestWorker

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

EnumerateUnmaskedInterrupts

Ein Zeiger auf eine EnumerateUnmaskedInterrupts-Routine . PoFx legt den Wert dieses Members fest. Die EnumerateUnmaskedInterrupts-Routine wird von PoFx implementiert. Pep ruft diese Routine auf, um Informationen zu den unmaskierten Interrupts anzufordern.

ProcessorHalt

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

RequestInterrupt

Ein Zeiger auf eine RequestInterrupt-Routine . PoFx legt den Wert dieses Members fest. Die RequestInterrupt-Routine wird von PoFx implementiert. Der PEP ruft diese Routine auf, um einen durch Edge ausgelösten Interrupt wiederzugeben, der möglicherweise verloren gegangen ist, nachdem die Hardwareplattform in einen Zustand des Low-Power-Systems eingetreten ist.

TransitionCriticalResource

Ein Zeiger auf eine TransitionCriticalResource-Routine . PoFx legt den Wert dieses Members fest. Die TransitionCriticalResource-Routine wird von PoFx implementiert. Pep ruft diese Routine auf, um wichtige Systemressourcen in den Leerlauf zu überstellen.

ProcessorIdleVeto

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

PlatformIdleVeto

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

UpdateProcessorIdleState

Ein Zeiger auf eine UpdateProcessorIdleState-Routine . PoFx legt den Wert dieses Members fest. Die UpdateProcessorIdleState-Routine wird von PoFx implementiert. 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 Members fest. Die UpdatePlatformIdleState-Routine wird von PoFx implementiert. Pep ruft diese Routine auf, um die Eigenschaften des angegebenen Plattform-Leerlaufzustands zu aktualisieren.

Hinweise

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Wird ab Windows 10 unterstützt.
Kopfzeile pep_x.h

Weitere Informationen