IOCTL_HPMI_BATTERY_UTILIZATION_HINT IOCTL (hpmi.h)
[一些信息与预发布产品相关，在商业发行之前可能发生实质性修改。 Microsoft 对于此处提供的信息不作任何明示或默示的担保。]
设置发送到 HPMI 的命令以提供电池利用率提示。
主要代码
输入缓冲区
I/O 请求数据包的 AssociatedIrp.SystemBuffer 成员 (IRP) 指向发起方分配的缓冲区，该缓冲区用作请求的输入缓冲区和输出缓冲区。 输入时，此缓冲区包含 HPMI_BATTERY_UTILIZATION_HINT 结构，其中版本设置为有效值。
输入缓冲区长度
IRP 当前 I/O 堆栈位置 (IO_STACK_LOCATION) 的 Parameters.DeviceIoControl.InputBufferLength 成员设置为 AssociatedIrp.SystemBuffer 成员指向的缓冲区的大小（以字节为单位）。 此大小必须大于或等于 sizeof HPMI_BATTERY_UTILIZATION_HINT 结构，否则请求将失败并出现错误状态STATUS_INVALID_PARAMETER。
输出缓冲区
TBD
输出缓冲区长度
TBD
输入/输出缓冲区
TBD
输入/输出缓冲区长度
TBD
状态块
Irp->如果请求成功，IoStatus.Status 设置为 STATUS_SUCCESS。 否则， 状态 为相应的错误条件作为 NTSTATUS 代码，例如STATUS_INVALID_PARAMETER。
注解
如果 HPMI 请求HPMI_REQUEST_SERVICE_BATTERY_UTILIZATION_HINTS服务，可能会多次发出此 IOCTL。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Windows 10 版本 1709 及更高版本的 Windows 操作系统。 |
| 标头 | hpmi.h (包括 Hpmi.h) |
另请参阅
IOCTL_HPMI_BATTERY_UTILIZATION_HINT
WdfIoTargetSendInternalIoctlOthersSynchronously
WdfIoTargetSendInternalIoctlSynchronously