IOCTL_STORAGE_DEVICE_POWER_CAP IOCTL (ntddstor.h)

  • Article

Un pilote peut utiliser IOCTL_STORAGE_DEVICE_POWER_CAP pour spécifier un niveau de consommation d’énergie opérationnelle maximal pour un périphérique de stockage. Le système d’exploitation fera de son mieux pour passer l’appareil à un état d’alimentation qui ne dépassera pas le maximum donné ; Toutefois, cela dépend de ce que l’appareil prend en charge. Le maximum réel peut être inférieur ou supérieur au maximum souhaité.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Irp->AssociatedIrp.SystemBuffer contient une structure STORAGE_DEVICE_POWER_CAP qui spécifie la puissance maximale.

Longueur de la mémoire tampon d’entrée

  • Parameters.DeviceIoControl.InputBufferLength indique la taille, en octets, de la mémoire tampon de paramètre d’entrée sur Irp-AssociatedIrp.SystemBuffer>, qui doit être supérieure ou égale à sizeof(STORAGE_DEVICE_POWER_CAP).

Mémoire tampon de sortie

Si l’opération réussit, la mémoire tampon de sortie dans Irp-AssociatedIrp.SystemBuffer> contiendra une structure STORAGE_DEVICE_POWER_CAP.

Longueur de la mémoire tampon de sortie

Parameters.DeviceIoControl.OutputBufferLength indique la taille, en octets, de la mémoire tampon des paramètres de sortie sur Irp-AssociatedIrp.SystemBuffer>. OutputBufferLength doit être supérieur ou égal à sizeof(STORAGE_DEVICE_POWER_CAP).

Bloc d’état

Le champ Informations est défini sur le nombre d’octets retournés. Le champ État est défini sur STATUS_SUCCESS, ou éventuellement sur STATUS_INVALID_DEVICE_REQUEST, STATUS_INVALID_PARAMETER ou STATUS_NOT_SUPPORTED.

Remarques

Pour un redémarrage, l’effet IOCTL_STORAGE_DEVICE_POWER_CAP n’est pas persistant. Pour un cycle de réinitialisation/d’alimentation d’un appareil NVMe, l’effet de l’IOCTL est persistant.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Serveur minimal pris en charge Windows Server 2016
En-tête ntddstor.h (inclure Ntddstor.h)

Voir aussi

IO_STATUS_BLOCK

STORAGE_DEVICE_POWER_CAP

STORAGE_DEVICE_POWER_CAP_UNITS