PEP_WORK_POWER_CONTROL-Struktur (pepfx.h)

Artikel
03/01/2024

Die PEP_WORK_POWER_CONTROL-Struktur enthält die Parameter für eine Energiesteuerungsanforderung , 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;

Member

DeviceHandle

Ein POHANDLE-Wert, der den Prozessor identifiziert. Das 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 durch PEP definierten Kontextwert. Der PEP kann diesen Wert verwenden, um eine Meldung zur Energiesteuerungsanforderung eindeutig zu identifizieren (falls pep mehrere Anforderungen mit demselben Steuerungscode an 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 des Puffers in Bytes, auf den InBuffer verweist.

[in] OutBuffer

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

[in] OutBufferSize

Die Größe des Puffers in Bytes, auf den outBuffer verweist.

Hinweise

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

Pep stellt eine Energiesteuerungsanforderung aus einem Workerthread aus. Das Windows Power Management Framework (PoFx) leitet diese Anforderung weiter, indem die PowerControlCallback-Routine des Prozessortreibers aufgerufen wird, wenn der Treiber diese Routine implementiert.