IOCTL_STORAGE_DEVICE_POWER_CAP IOCTL (ntddstor.h)

Un driver può usare IOCTL_STORAGE_DEVICE_POWER_CAP per specificare un livello massimo di consumo di energia operativa per un dispositivo di archiviazione. Il sistema operativo farà del suo meglio per eseguire la transizione del dispositivo a uno stato di alimentazione che non supererà il valore massimo specificato; Tuttavia, questo dipende da ciò che il dispositivo supporta. Il valore massimo effettivo può essere minore o maggiore del valore massimo desiderato.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Irp->AssociatedIrp.SystemBuffer contiene una struttura STORAGE_DEVICE_POWER_CAP che specifica la potenza massima.

Lunghezza del buffer di input

• Parameters.DeviceIoControl.InputBufferLength indica le dimensioni, in byte, del buffer dei parametri di input in Irp-AssociatedIrp.SystemBuffer>, che deve essere maggiore o uguale a sizeof(STORAGE_DEVICE_POWER_CAP).

Buffer di output

Se l'operazione ha esito positivo, il buffer di output in Irp-AssociatedIrp.SystemBuffer> conterrà una struttura STORAGE_DEVICE_POWER_CAP.

Lunghezza del buffer di output

Parameters.DeviceIoControl.OutputBufferLength indica le dimensioni, in byte, del buffer dei parametri di output in Irp-AssociatedIrp.SystemBuffer>. OutputBufferLength deve essere maggiore o uguale a sizeof(STORAGE_DEVICE_POWER_CAP).

Blocco dello stato

Il campo Informazioni viene impostato sul numero di byte restituiti. Il campo Stato è impostato su STATUS_SUCCESS o su STATUS_INVALID_DEVICE_REQUEST, STATUS_INVALID_PARAMETER o STATUS_NOT_SUPPORTED.

Commenti

Per un riavvio, l'effetto IOCTL_STORAGE_DEVICE_POWER_CAP non è persistente. Per un ciclo di reimpostazione/alimentazione del dispositivo NVMe, l'effetto IOCTL è persistente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10
Server minimo supportato	Windows Server 2016
Intestazione	ntddstor.h (include Ntddstor.h)

Vedi anche

IO_STATUS_BLOCK

STORAGE_DEVICE_POWER_CAP

STORAGE_DEVICE_POWER_CAP_UNITS