IOCTL_HPMI_BATTERY_UTILIZATION_HINT IOCTL (hpmi.h)

Artikel
02/07/2025

[Einige Informationen beziehen sich auf vorab veröffentlichte Produkte, die vor der kommerziellen Veröffentlichung erheblich geändert werden können. Microsoft übernimmt keine Gewährleistungen, ausdrücklich oder konkludent in Bezug auf die hier bereitgestellten Informationen.]

Legen Sie den Befehl fest, der an HPMI gesendet wird, um Hinweise zur Akkunutzung bereitzustellen.

Wichtige Vorläufige Informationen

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

The AssociatedIrp.SystemBuffer member of the I/O request packet (IRP) points to an initiator-associated buffer that is used both as the input buffer and the output buffer for the request. Bei eingabe enthält dieser Puffer eine HPMI_BATTERY_UTILIZATION_HINT Struktur, in der die Version auf einen gültigen Wert festgelegt ist.

Eingabepufferlänge

Das Parameters.DeviceIoControl.InputBufferLength-Element der aktuellen I/O-Stapelposition (IO_STACK_LOCATION) des IRP wird auf die Größe in Bytes des Puffers festgelegt, auf den das AssociatedIrp.SystemBuffer-Element verweist. Diese Größe muss größer oder gleich der Größe HPMI_BATTERY_UTILIZATION_HINT Struktur sein, oder die Anforderung schlägt mit einem Fehlerstatus von STATUS_INVALID_PARAMETER fehl.

Ausgabepuffer

TBD

Länge des Ausgabepuffers

TBD

Eingabe-/Ausgabepuffer

TBD

Länge des Eingabe-/Ausgabepuffers

TBD

Statusblock

Irp->IoStatus.Status auf STATUS_SUCCESS festgelegt ist, wenn die Anforderung erfolgreich ist. Andernfalls Status der entsprechenden Fehlerbedingung als NTSTATUS- Code, z. B. STATUS_INVALID_PARAMETER.

Bemerkungen

Diese IOCTL kann mehrmals ausgestellt werden, wenn HPMI HPMI_REQUEST_SERVICE_BATTERY_UTILIZATION_HINTS Service anfordert.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 10, Version 1709 und höher, Versionen von Windows-Betriebssystemen.
Header-	hpmi.h (enthalten Hpmi.h)