PEP_WORK_POWER_CONTROL Struktur (pep_x.h)

Artikel
02/07/2025

Die PEP_WORK_POWER_CONTROL-Struktur enthält die Parameter für eine Leistungssteuerungsanforderung, die das Plattformerweiterungs-Plug-In (PEP) direkt an einen Prozessortreiber sendet.

Syntax

typedef struct _PEP_WORK_POWER_CONTROL {
       POHANDLE DeviceHandle;
  [in] LPCGUID  PowerControlCode;
       PVOID    RequestContext;
  [in] PVOID    InBuffer;
  [in] SIZE_T   InBufferSize;
  [in] PVOID    OutBuffer;
  [in] SIZE_T   OutBufferSize;
} PEP_WORK_POWER_CONTROL, *PPEP_WORK_POWER_CONTROL;

Angehörige

DeviceHandle

Ein POHANDLE-Wert, der den Prozessor identifiziert. Der PEP hat dieses Handle in einer vorherigen PEP_DPM_REGISTER_DEVICE Benachrichtigung erhalten.

[in] PowerControlCode

Ein Zeiger auf einen GUID-Wert, der den auszuführenden Energiesteuerungsvorgang angibt.

RequestContext

Ein Zeiger auf einen PEP-definierten Kontextwert. Der PEP kann diesen Wert verwenden, um eine Anforderungsnachricht für die Energiesteuerung eindeutig zu identifizieren (falls der PEP mehrere Anforderungen mit demselben Steuercode auf dasselbe Gerät ausgibt).

[in] InBuffer

Ein Zeiger auf einen vom Treiber zugewiesenen Eingabepuffer, der die Eingabeparameter für diesen Energiesteuerungsvorgang enthält.

[in] InBufferSize

Die Größe in Byte des Puffers, auf den InBufferverweist.

[in] OutBuffer

Ein Zeiger auf einen vom Treiber zugewiesenen Ausgabepuffer, in den der PEP die Ergebnisse dieses Leistungssteuerungsvorgangs schreibt.

[in] OutBufferSize

Die Größe in Byte des Puffers, auf den OutBufferverweist.

Bemerkungen

Das PowerControl Element der PEP_WORK_INFORMATION-Struktur ist ein Zeiger auf eine PEP_WORK_POWER_CONTROL Struktur.

Der PEP gibt eine Energiesteuerungsanforderung von einem Arbeitsthread aus. Das Windows Power Management Framework (PoFx) leitet diese Anforderung weiter, indem die PowerControlCall back-Routine des Prozessortreibers aufgerufen wird, wenn der Treiber diese Routine implementiert.