IOCTL_HPMI_BATTERY_UTILIZATION_HINT IOCTL (hpmi.h)

Artículo
03/05/2024

[Parte de la información hace referencia a la versión preliminar del producto, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información que se ofrece aquí].

Establezca el comando enviado a HPMI para proporcionar sugerencias de uso de la batería.

Importante Información preliminar

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

El miembro AssociatedIrp.SystemBuffer del paquete de solicitud de E/S (IRP) apunta a un búfer asignado por el iniciador que se usa tanto como búfer de entrada como búfer de salida para la solicitud. En la entrada, este búfer contiene una estructura HPMI_BATTERY_UTILIZATION_HINT en la que la versión se establece en un valor válido.

Longitud del búfer de entrada

El miembro Parameters.DeviceIoControl.InputBufferLength de la ubicación de pila de E/S actual del IRP (IO_STACK_LOCATION) se establece en el tamaño en bytes del búfer al que apunta el miembro AssociatedIrp.SystemBuffer. Este tamaño debe ser mayor o igual que sizeof HPMI_BATTERY_UTILIZATION_HINT estructura o se producirá un error en la solicitud con un estado de error de STATUS_INVALID_PARAMETER.

Búfer de salida

TBD

Longitud del búfer de salida

TBD

Búfer de entrada y salida

TBD

Longitud del búfer de entrada y salida

TBD

Bloque de estado

Irp->IoStatus.Status se establece en STATUS_SUCCESS si la solicitud se realiza correctamente. De lo contrario, estado de la condición de error adecuada como código NTSTATUS , por ejemplo, STATUS_INVALID_PARAMETER.

Comentarios

Este IOCTL puede emitirse varias veces si HPMI solicita HPMI_REQUEST_SERVICE_BATTERY_UTILIZATION_HINTS servicio.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 10, versión 1709 y versiones posteriores de los sistemas operativos Windows.
Encabezado	hpmi.h (incluya Hpmi.h)