IOCTL_STORAGE_FIRMWARE_GET_INFO IOCTL (ntddstor.h)
Ein Treiber kann IOCTL_STORAGE_FIRMWARE_GET_INFO verwenden, um ein Speichergerät nach detaillierten Firmwareinformationen abzufragen. Bei einem erfolgreichen Aufruf werden Informationen zu Firmwarerevisionen, Aktivitätsstatus sowie Lese-/Schreibattribute für jeden Slot zurückgegeben. Die Menge der zurückgegebenen Daten variiert je nach Speicherprotokoll.
Hauptcode
Eingabepuffer
Parameters.DeviceIoControl.InputBufferLength gibt die Größe des Parameterpuffers in Bytes bei Irp->AssociatedIrp.SystemBuffer an, die >= sizeof(STORAGE_HW_FIRMWARE_INFO_QUERY) sein muss. Irp->AssociatedIrp.SystemBuffer enthält STORAGE_HW_FIRMWARE_INFO_QUERY Daten, die das Ziel der Anforderung angibt. Parameters.DeviceIoControl.OutputBufferLength gibt die Anzahl der Bytes an, die in Irp->AssociatedIrp.SystemBuffer geschrieben werden können. OutputBufferLength muss sizeof(STORAGE_HW_FIRMWARE_INFO) + sizeof(STORAGE_HW_FIRMWARE_SLOT_INFO) * (STORAGE_HW_FIRMWARE_INFO sein. SlotCount -1).Eingabepufferlänge
Die Länge von .
Ausgabepuffer
Der Treiber gibt Abfragedaten an den Puffer unter Irp-AssociatedIrp.SystemBuffer> zurück. Der Ausgabepuffer sollte eine STORAGE_HW_FIRMWARE_INFO - und STORAGE_HW_FIRMWARE_SLOT_INFO-Struktur für jeden Slot des Geräts enthalten.
Länge des Ausgabepuffers
Die Länge von .
Statusblock
Das Feld Information ist auf die Anzahl der zurückgegebenen Bytes festgelegt. Das Feld Status ist auf STATUS_SUCCESS oder möglicherweise auf STATUS_INVALID_DEVICE_REQUEST, STATUS_INVALID_PARAMETER oder STATUS_NOT_SUPPORTED festgelegt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Kopfzeile | ntddstor.h (include Ntddstor.h) |
Weitere Informationen
IOCTL_STORAGE_FIRMWARE_ACTIVATE
IOCTL_STORAGE_FIRMWARE_DOWNLOAD