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;
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 auszuführenden Energiesteuerungsvorgang angibt. Dies ist derselbe Wert wie der anfordernde Treiber, der als PowerControlCode Parameter an die PoFxPowerControl Routine bereitgestellt wird.
[in] InBuffer
Ein Zeiger auf einen vom Treiber zugewiesenen Eingabepuffer, der die Eingabeparameter für diesen Energiesteuerungsvorgang enthält. Dies ist derselbe Wert wie der anfordernde Treiber, der als InBuffer Parameter an die PoFxPowerControl Routine bereitgestellt wird.
[in] InBufferSize
Die Größe in Byte des Puffers, auf den InBufferverweist. Dies ist derselbe Wert wie der anfordernde Treiber, der als InBufferSize Parameter für die PoFxPowerControl- Routine angegeben wird.
[in] OutBuffer
Ein Zeiger auf einen vom Treiber zugewiesenen Ausgabepuffer, in den der PEP die Ergebnisse dieses Leistungssteuerungsvorgangs schreibt. Dies ist der gleiche Wert wie der anfordernde Treiber, der als OutBuffer-Parameter Parameter an die PoFxPowerControl- Routine bereitgestellt wird.
[in] OutBufferSize
Die Größe in Byte des Puffers, auf den OutBufferverweist.
[out] BytesReturned
Die Anzahl der Bytes, die der PEP in den Ausgabepuffer geschrieben hat, auf OutBufferverweist.
[out] Status
Der Status des angeforderten Energiesteuerungsvorgangs. 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 Elemente 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 Member verweist.
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.
Der Treiber für ein Gerät kann die PoFxPowerControl- Routine aufrufen, um einen Stromsteuerungsvorgang auf dem Gerät anzufordern. Während dieses Aufrufs delegiert PoFx die Behandlung dieser Anforderung an den PEP, der das Gerät besitzt. Das PowerControlCode Member 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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 10 unterstützt. |
| Header- | pepfx.h (include Pep_x.h) |