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 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 corrispondenza di 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 corrispondenza di 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 di stato
Il campoInformazioniè impostato sul numero di byte restituiti. Il campo Stato è impostato su STATUS_SUCCESS oppure su STATUS_INVALID_DEVICE_REQUEST, STATUS_INVALID_PARAMETER o STATUS_NOT_SUPPORTED.
Osservazioni
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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10 |
| server minimo supportato | Windows Server 2016 |
| intestazione | ntddstor.h (include Ntddstor.h) |