Condividi tramite


IOCTL_HPMI_BATTERY_UTILIZATION_HINT IOCTL (hpmi.h)

[Alcune informazioni riguardano il prodotto non rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce garanzie, esplicite o implicite, relativamente alle informazioni fornite qui.

Impostare il comando inviato a HPMI per fornire suggerimenti per l'utilizzo della batteria.

informazioni preliminari importanti
 

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Il membro AssociatedIrp.SystemBuffer del pacchetto di richiesta I/O punta a un buffer allocato dall'iniziatore usato sia come buffer di input che come buffer di output per la richiesta. In caso di input, questo buffer contiene una struttura HPMI_BATTERY_UTILIZATION_HINT in cui la versione è impostata su un valore valido.

Lunghezza del buffer di input

Il membro Parameters.DeviceIoControl.InputBufferLength del percorso dello stack I/O corrente di IRP (IO_STACK_LOCATION) viene impostato sulle dimensioni in byte del buffer a cui punta il membro AssociatedIrp.SystemBuffer. Questa dimensione deve essere maggiore o uguale a sizeof HPMI_BATTERY_UTILIZATION_HINT struttura oppure la richiesta avrà esito negativo con uno stato di errore di STATUS_INVALID_PARAMETER.

Buffer di output

TBD

Lunghezza del buffer di output

TBD

Buffer di input/output

TBD

Lunghezza del buffer di input/output

TBD

Blocco di stato

Irp-> IoStatus.Status è impostato su STATUS_SUCCESS se la richiesta ha esito positivo. In caso contrario, stato alla condizione di errore appropriata come codice NTSTATUS, ad esempio STATUS_INVALID_PARAMETER.

Osservazioni

Questo IOCTL può essere generato più volte se le richieste HPMI HPMI_REQUEST_SERVICE_BATTERY_UTILIZATION_HINTS servizio.

Fabbisogno

Requisito Valore
client minimo supportato Disponibile in Windows 10 versione 1709 e successive dei sistemi operativi Windows.
intestazione hpmi.h (include Hpmi.h)

Vedere anche

creazione di richieste IOCTL nei driver

HPMI_HINT_BOOL

IOCTL_HPMI_BATTERY_UTILIZATION_HINT

IRP

WdfIoTargetSendInternalIoctlOthersSynchronously

WdfIoTargetSendInternalIoctlSynchronously

WdfIoTargetSendIoctlSynchronously

hpmi.h