IOCTL_HPMI_BATTERY_UTILIZATION_HINT IOCTL (hpmi.h)

Artigo
08/07/2023

[Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não fornece nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.]

Defina o comando enviado para HPMI para fornecer dicas de utilização da bateria.

Importante Informações preliminares

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

O membro AssociatedIrp.SystemBuffer do IRP (pacote de solicitação de E/S) aponta para um buffer alocado pelo iniciador que é usado como o buffer de entrada e o buffer de saída para a solicitação. Na entrada, esse buffer contém uma estrutura HPMI_BATTERY_UTILIZATION_HINT na qual a versão é definida como um valor válido.

Comprimento do buffer de entrada

O membro Parameters.DeviceIoControl.InputBufferLength do local da pilha de E/S atual do IRP (IO_STACK_LOCATION) é definido como o tamanho em bytes do buffer apontado pelo membro AssociatedIrp.SystemBuffer. Esse tamanho deve ser maior ou igual a sizeof HPMI_BATTERY_UTILIZATION_HINT estrutura ou a solicitação falhará com um erro status de STATUS_INVALID_PARAMETER.

Buffer de saída

TBD

Comprimento do buffer de saída

TBD

Buffer de entrada/saída

TBD

Comprimento do buffer de entrada/saída

TBD

Bloco de status

Irp->IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Caso contrário, Status para a condição de erro apropriada como um código NTSTATUS , por exemplo, STATUS_INVALID_PARAMETER.

Comentários

Esse IOCTL poderá ser emitido várias vezes se a HPMI solicitar HPMI_REQUEST_SERVICE_BATTERY_UTILIZATION_HINTS serviço.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível em Windows 10, versão 1709 e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	hpmi.h (inclua Hpmi.h)