PEP_POWER_CONTROL_COMPLETE-Struktur (pepfx.h)

Artikel
08/07/2023

Die PEP_POWER_CONTROL_COMPLETE-Struktur enthält status Informationen für einen Energiesteuerungsvorgang, den der PEP zuvor angefordert hat und die der Gerätetreiber abgeschlossen hat.

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;

Member

[in] DeviceHandle

Ein PEPHANDLE-Wert, der das Gerät identifiziert. Das 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 der gleiche Wert, den der PEP als Reaktion auf die PEP_DPM_WORK Benachrichtigung zum Initiieren des Energiesteuerungsvorgangs angegeben hat.

[in] RequestContext

Ein Zeiger auf den Anforderungskontext, der vom PEP in der PEP_WORK_INFORMATION-Struktur gesendet wurde, die der PEP in der ursprünglichen Arbeitsanforderung bereitgestellt hat. In der Regel verweist dieses Element auf eine Struktur, die einen Zeiger auf einen Ausgabepuffer enthält, der die Ergebnisse des vom PEP angeforderten Energiesteuerungsvorgangs enthält.

[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

Die status des Energiesteuerungsvorgangs. Wenn der Vorgang erfolgreich war, legt pep diesen Member auf STATUS_SUCCESS fest. Andernfalls legt pep diesen Member auf einen entsprechenden Fehler status Code fest.

Hinweise

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 pep das Statuselement 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
Unterstützte Mindestversion (Client)	Wird ab Windows 10 unterstützt.
Kopfzeile	pepfx.h (einschließlich Pep_x.h)

Weitere Informationen

GUID

Freigeben über