IOCTL_STORAGE_FIRMWARE_GET_INFO IOCTL (ntddstor.h)
Un pilote peut utiliser IOCTL_STORAGE_FIRMWARE_GET_INFO pour interroger un périphérique de stockage pour obtenir des informations détaillées sur le microprogramme. Un appel réussi retourne des informations sur les révisions de microprogrammes, le statut de l’activité, ainsi que les attributs de lecture/écriture pour chaque emplacement. La quantité de données retournées varie en fonction du protocole de stockage.
Code principal
Mémoire tampon d'entrée
Parameters.DeviceIoControl.InputBufferLength indique la taille, en octets, de la mémoire tampon de paramètres sur Irp->AssociatedIrp.SystemBuffer, qui doit être >= sizeof(STORAGE_HW_FIRMWARE_INFO_QUERY). Irp->AssociatedIrp.SystemBuffer contient STORAGE_HW_FIRMWARE_INFO_QUERY données qui spécifient la cible de la requête. Parameters.DeviceIoControl.OutputBufferLength indique le nombre d’octets pouvant être écrits dans Irp->AssociatedIrp.SystemBuffer. OutputBufferLength doit être sizeof(STORAGE_HW_FIRMWARE_INFO) + sizeof(STORAGE_HW_FIRMWARE_SLOT_INFO) * (STORAGE_HW_FIRMWARE_INFO. SlotCount -1).Longueur de la mémoire tampon d’entrée
Longueur de .
Mémoire tampon de sortie
Le pilote retourne des données de requête à la mémoire tampon sur Irp-AssociatedIrp.SystemBuffer>. La mémoire tampon de sortie doit contenir une structure STORAGE_HW_FIRMWARE_INFO et STORAGE_HW_FIRMWARE_SLOT_INFO pour chaque emplacement de l’appareil.
Longueur de la mémoire tampon de sortie
Longueur de .
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.
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
IOCTL_STORAGE_FIRMWARE_ACTIVATE
IOCTL_STORAGE_FIRMWARE_DOWNLOAD