IOCTL_STORAGE_FIRMWARE_GET_INFO IOCTL (ntddstor.h)

Article
02/26/2024

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

IRP_MJ_DEVICE_CONTROL

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.