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
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) |