IOCTL_STORAGE_DEVICE_POWER_CAP IOCTL (ntddstor.h)
Un controlador puede usar IOCTL_STORAGE_DEVICE_POWER_CAP para especificar un nivel máximo de consumo de energía operativo para un dispositivo de almacenamiento. El sistema operativo hará lo mejor para realizar la transición del dispositivo a un estado de alimentación que no superará el máximo especificado; sin embargo, esto depende de lo que admita el dispositivo. El máximo real puede ser menor o mayor que el máximo deseado.
Código principal
Búfer de entrada
Irp->AssociatedIrp.SystemBuffer contiene una estructura STORAGE_DEVICE_POWER_CAP que especifica la potencia máxima.
Longitud del búfer de entrada
-
Parameters.DeviceIoControl.InputBufferLength indica el tamaño, en bytes, del búfer de parámetros de entrada en Irp->AssociatedIrp.SystemBuffer, que debe ser mayor o igual que
sizeof(STORAGE_DEVICE_POWER_CAP).
Búfer de salida
Si la operación se realiza correctamente, el búfer de salida en Irp->AssociatedIrp.SystemBuffer contendrá una estructura de STORAGE_DEVICE_POWER_CAP.
Longitud del búfer de salida
Parameters.DeviceIoControl.OutputBufferLength indica el tamaño, en bytes, del búfer de parámetros de salida en Irp->AssociatedIrp.SystemBuffer.
OutputBufferLength debe ser mayor o igual que sizeof(STORAGE_DEVICE_POWER_CAP).
Bloque de estado
El campoinformación dese establece en el número de bytes devueltos. El campo Estado de está establecido en STATUS_SUCCESS, o posiblemente en STATUS_INVALID_DEVICE_REQUEST, STATUS_INVALID_PARAMETER o STATUS_NOT_SUPPORTED.
Observaciones
Para un reinicio, el efecto IOCTL_STORAGE_DEVICE_POWER_CAP no es persistente. Para un ciclo de restablecimiento o energía de un dispositivo NVMe, el efecto del IOCTL es persistente.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10 |
| servidor mínimo admitido | Windows Server 2016 |
| encabezado de | ntddstor.h (incluya Ntddstor.h) |