IOCTL_HPMI_BATTERY_UTILIZATION_HINT IOCTL (hpmi.h)

Статья
02/07/2025

[Некоторые сведения связаны с предварительно выпущенным продуктом, который может быть существенно изменен до его коммерческого выпуска. Корпорация Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых в отношении информации, предоставленной здесь.]

Задайте команду, отправленную в HPMI, чтобы предоставить указания по использованию батареи.

важные предварительные сведения

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Элемент AssociatedIrp.SystemBuffer пакета запросов ввода-вывода (IRP) указывает на выделенный инициатором буфер, который используется как входной буфер, так и выходной буфер запроса. В входных данных этот буфер содержит HPMI_BATTERY_UTILIZATION_HINT структуру, в которой версия имеет допустимое значение.

Длина входного буфера

Элемент Parameters.DeviceIoControl.InputBufferLength текущего расположения ввода-вывода IRP (IO_STACK_LOCATION) имеет размер в байтах буфера, на который указывает член AssociatedIrp.SystemBuffer. Этот размер должен быть больше или равен размеру структуры HPMI_BATTERY_UTILIZATION_HINT, или запрос завершится ошибкой с состоянием STATUS_INVALID_PARAMETER.

Выходной буфер

ТБD

Длина выходного буфера

ТБD

Буфер входных и выходных данных

ТБD

Длина буфера ввода и вывода

ТБD

Блок состояния

Irp->IoStatus.Status STATUS_SUCCESS, если запрос выполнен успешно. В противном случае состояние соответствующего условия ошибки в качестве кода NTSTATUS, например STATUS_INVALID_PARAMETER.

Замечания

Этот IOCTL может быть выдан несколько раз, если запросы HPMI HPMI_REQUEST_SERVICE_BATTERY_UTILIZATION_HINTS службе.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 10 версии 1709 и более поздних версиях операционных систем Windows.
заголовка	hpmi.h (включая Hpmi.h)