PEP_POWER_CONTROL_COMPLETE Struktur (pepfx.h)

Artikel
02/07/2025

Die PEP_POWER_CONTROL_COMPLETE Struktur enthält Statusinformationen für einen Leistungssteuerungsvorgang, den der PEP zuvor angefordert hat und dass der Gerätetreiber abgeschlossen wurde.

Syntax

typedef struct _PEP_POWER_CONTROL_COMPLETE {
  [in] PEPHANDLE DeviceHandle;
  [in] LPCGUID   PowerControlCode;
  [in] PVOID     RequestContext;
  [in] SIZE_T    BytesReturned;
  [in] NTSTATUS  Status;
} PEP_POWER_CONTROL_COMPLETE, *PPEP_POWER_CONTROL_COMPLETE;

Angehörige

[in] DeviceHandle

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

[in] PowerControlCode

Ein Zeiger auf einen GUID-Wert, der den ausgeführten Energiesteuerungsvorgang angibt. Dies ist derselbe Wert, den der PEP als Reaktion auf die PEP_DPM_WORK-Benachrichtigung zum Initiieren des Stromsteuerungsvorgangs bereitgestellt hat.

[in] RequestContext

Ein Zeiger auf den Anforderungskontext, der von der PEP in der PEP_WORK_INFORMATION Struktur gesendet wurde, die der PEP in der ursprünglichen Arbeitsanforderung angegeben hat. In der Regel verweist dieses Element auf eine Struktur, die einen Zeiger auf einen Ausgabepuffer enthält, um die Ergebnisse des Vom PEP angeforderten Energiesteuerungsvorgangs zu enthalten.

[in] BytesReturned

Die Größe der vom Treiber im Ausgabepuffer gespeicherten Ergebnisdaten in Bytes. Weitere Informationen zu diesem Puffer finden Sie in der Beschreibung des RequestContext Members.

[in] Status

Der Status des Energiesteuerungsvorgangs. Wenn der Vorgang erfolgreich war, 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_COMPLETE-Benachrichtigung verwendet. Alle fünf Elemente der Struktur enthalten Eingabewerte, die von

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Wird ab Windows 10 unterstützt.
Header-	pepfx.h (include Pep_x.h)

Siehe auch

GUID

Freigeben über