PEP_WORK_POWER_CONTROL-Struktur (pep_x.h)

Artikel
08/07/2023

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 Energiesteuerungsanforderungsnachricht eindeutig zu identifizieren (falls pep mehrere Anforderungen mit demselben Steuercode an dasselbe Gerät sendet).

[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 in InBuffer verwiesen wird.

[in] OutBuffer

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

[in] OutBufferSize

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

Hinweise

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

Pep gibt eine Energiesteuerungsanforderung von 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.