IOCTL_HPMI_BATTERY_UTILIZATION_HINT IOCTL (hpmi.h)

Artikel
02/26/2024

[Einige Informationen beziehen sich auf die Vorabversion, die vor der kommerziellen Freigabe möglicherweise wesentlichen Änderungen unterliegt. Microsoft übernimmt für die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklicher noch impliziter Art.]

Legen Sie den an HPMI gesendeten Befehl fest, um Hinweise zur Akkuauslastung bereitzustellen.

Wichtig Vorläufige Informationen

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Der AssociatedIrp.SystemBuffer-Member des E/A-Anforderungspakets (IRP) verweist auf einen vom Initiator zugewiesenen Puffer, der sowohl als Eingabepuffer als auch als Ausgabepuffer für die Anforderung verwendet wird. Bei der Eingabe enthält dieser Puffer eine HPMI_BATTERY_UTILIZATION_HINT-Struktur , in der die Version auf einen gültigen Wert festgelegt ist.

Länge des Eingabepuffers

Der Parameters.DeviceIoControl.InputBufferLength-Member des aktuellen I/O-Stapelspeicherorts (IO_STACK_LOCATION) des IRP wird auf die Größe in Byte des Puffers festgelegt, auf den vom AssociatedIrp.SystemBuffer-Member verwiesen wird. Diese Größe muss größer oder gleich der Größe HPMI_BATTERY_UTILIZATION_HINT Struktur sein, andernfalls schlägt die Anforderung mit einem Fehler status STATUS_INVALID_PARAMETER fehl.

Ausgabepuffer

TBD

Länge des Ausgabepuffers

TBD

Eingabe-/Ausgabepuffer

TBD

Länge des Eingabe-/Ausgabepuffers

TBD

Statusblock

Irp->IoStatus.Status wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls wird der Status für die entsprechende Fehlerbedingung als NTSTATUS-Code verwendet, z. B. STATUS_INVALID_PARAMETER.

Hinweise

Diese IOCTL kann mehrmals ausgegeben werden, wenn HPMI HPMI_REQUEST_SERVICE_BATTERY_UTILIZATION_HINTS Dienst anfordert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 10 Version 1709 und höher der Windows-Betriebssysteme.
Kopfzeile	hpmi.h (hpmi.h einschließen)