PEP_POWER_CONTROL_REQUEST Struktur (pepfx.h)

Die PEP_POWER_CONTROL_REQUEST Struktur enthält eine Anforderung eines Treibers für einen Leistungssteuerungsvorgang.

Syntax

typedef struct _PEP_POWER_CONTROL_REQUEST {
  [in]  PEPHANDLE DeviceHandle;
  [in]  LPCGUID   PowerControlCode;
  [in]  PVOID     InBuffer;
  [in]  SIZE_T    InBufferSize;
  [in]  PVOID     OutBuffer;
  [in]  SIZE_T    OutBufferSize;
  [out] SIZE_T    BytesReturned;
  [out] NTSTATUS  Status;
} PEP_POWER_CONTROL_REQUEST, *PPEP_POWER_CONTROL_REQUEST;

Member

[in] DeviceHandle

Ein PEPHANDLE-Wert, der das Gerät identifiziert. Der PEP hat diesen Handle als Reaktion auf eine vorherige PEP_DPM_REGISTER_DEVICE Benachrichtigung bereitgestellt.

[in] PowerControlCode

Ein Zeiger auf einen GUID-Wert, der den auszuführenden Stromsteuerungsvorgang angibt. Dies ist derselbe Wert, den der anfordernde Treiber als PowerControlCode-Parameter für die PoFxPowerControl-Routine bereitgestellt hat.

[in] InBuffer

Ein Zeiger auf einen vom Treiber zugewiesenen Eingabepuffer, der die Eingabeparameter für diesen Leistungssteuerungsvorgang enthält. Dies ist derselbe Wert, den der anfordernde Treiber als InBuffer-Parameter für die PoFxPowerControl-Routine bereitgestellt hat.

[in] InBufferSize

Die Größe in Bytes des Puffers, auf die in InBuffer verwiesen wird. Dies ist derselbe Wert, den der anfordernde Treiber als InBufferSize-Parameter für die PoFxPowerControl-Routine bereitgestellt hat.

[in] OutBuffer

Ein Zeiger auf einen vom Treiber zugewiesenen Ausgabepuffer, in den der PEP die Ergebnisse dieses Leistungssteuerungsvorgangs schreibt. Dies ist derselbe Wert, den der anfordernde Treiber als OutBuffer-Parameter für die PoFxPowerControl-Routine bereitgestellt hat.

[in] OutBufferSize

Die Größe in Bytes des Puffers, auf die von OutBuffer verwiesen wird.

[out] BytesReturned

Die Anzahl der Bytes, die der PEP in den Ausgabepuffer geschrieben hat, verweist von OutBuffer.

[out] Status

Der Status des angeforderten Stromsteuerungsvorgangs. Wenn der Vorgang erfolgreich ist, legt der PEP dieses Element auf STATUS_SUCCESS fest. Andernfalls legt der PEP dieses Element auf einen geeigneten Fehlerstatuscode fest.

Bemerkungen

Diese Struktur wird von der PEP_DPM_POWER_CONTROL_REQUEST Benachrichtigung verwendet. Die ersten sechs Member der Struktur enthalten Eingabewerte, die vom Windows Power Management Framework (PoFx) bereitgestellt werden. Die letzten beiden Member enthalten Werte, die der PEP als Reaktion auf diese Benachrichtigung in die Struktur schreibt. Darüber hinaus schreibt der PEP in den Ausgabepuffer, auf den das OutBuffer-Element verweist.

Wenn der Ausgabepuffer zu klein ist, um alle Ergebnisdaten aus dem Vorgang zu empfangen, legt der PEP das Statuselement der Struktur auf STATUS_INSUFFICIENT_RESOURCES fest, legt das BytesReturned-Element auf die erforderliche Größe des Ausgabepuffers fest und schreibt (normalerweise) keine Daten in den Ausgabepuffer.

Der Treiber für ein Gerät kann die PoFxPowerControl-Routine aufrufen, um einen Stromsteuerungsvorgang auf dem Gerät anzufordern. Während dieses Anrufs delegiert PoFx die Behandlung dieser Anforderung an den PEP, der das Gerät besitzt. Das PowerControlCode-Element der PEP_POWER_CONTROL_REQUEST-Struktur enthält einen benutzerdefinierten Steuerelementcode, dessen Bedeutung sowohl vom Treiber als auch vom PEP für das Gerät verstanden wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Unterstützt ab Windows 10.
Header pepfx.h (include Pep_x.h)

Siehe auch

PEP_DPM_POWER_CONTROL_REQUEST

PEP_DPM_REGISTER_DEVICE

PoFxPowerControl