IOCTL_HPMI_BATTERY_UTILIZATION_HINT IOCTL (hpmi.h)

Article
02/07/2025

[Certaines informations concernent le produit préversion qui peut être sensiblement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, expresse ou implicite, en ce qui concerne les informations fournies ici.]

Définissez la commande envoyée à HPMI pour fournir des indicateurs d’utilisation de la batterie.

informations préliminaires importantes

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d’entrée

Le membre AssociatedIrp.SystemBuffer du paquet de requête d’E/S pointe vers une mémoire tampon allouée par l’initiateur qui est utilisée à la fois comme mémoire tampon d’entrée et mémoire tampon de sortie pour la requête. Lors de l’entrée, cette mémoire tampon contient une structure HPMI_BATTERY_UTILIZATION_HINT dans laquelle la version est définie sur une valeur valide.

Longueur de la mémoire tampon d’entrée

Le membre Parameters.DeviceIoControl.InputBufferLength de l’emplacement actuel de la pile d’E/S d’IRP (IO_STACK_LOCATION) est défini sur la taille en octets de la mémoire tampon pointée par le membre AssociatedIrp.SystemBuffer. Cette taille doit être supérieure ou égale à la structure de HPMI_BATTERY_UTILIZATION_HINT, ou la demande échoue avec un état d’erreur de STATUS_INVALID_PARAMETER.

Mémoire tampon de sortie

TBD

Longueur de la mémoire tampon de sortie

TBD

Mémoire tampon d’entrée/sortie

TBD

Longueur de la mémoire tampon d’entrée/sortie

TBD

Bloc d’état

> IoStatus.Status est défini sur STATUS_SUCCESS si la requête réussit. Sinon, 'état à la condition d’erreur appropriée en tant que code NTSTATUS, par exemple STATUS_INVALID_PARAMETER.

Remarques

Ce IOCTL peut être émis plusieurs fois si HPMI demande HPMI_REQUEST_SERVICE_BATTERY_UTILIZATION_HINTS service.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows 10, version 1709 et versions ultérieures des systèmes d’exploitation Windows.
d’en-tête	hpmi.h (include Hpmi.h)