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. Ein erfolgreicher Aufruf gibt Informationen zu Firmwarerevisionen, Aktivitätsstatus sowie Lese-/Schreibattributen für jeden Steckplatz zurück. Die zurückgegebene Datenmenge variiert je nach Speicherprotokoll.
Hauptcode
Eingabepuffer
Parameters.DeviceIoControl.InputBufferLength gibt die Größe des Parameterpuffers bei Irp->AssociatedIrp.SystemBufferan, die >= Größe(STORAGE_HW_FIRMWARE_INFO_QUERY) sein muss. Irp->AssociatedIrp.SystemBuffer enthält STORAGE_HW_FIRMWARE_INFO_QUERY Daten, die das Ziel der Anforderung angeben. Parameters.DeviceIoControl.OutputBufferLength gibt die Anzahl der Bytes an, die in Irp->AssociatedIrp.SystemBuffergeschrieben werden können. OutputBufferLength muss Größe(STORAGE_HW_FIRMWARE_INFO) + Größe(STORAGE_HW_FIRMWARE_SLOT_INFO) * (STORAGE_HW_FIRMWARE_INFO. SlotCount -1).Eingabepufferlänge
Die Länge von .
Ausgabepuffer
Der Treiber gibt Abfragedaten an den Puffer bei Irp->AssociatedIrp.SystemBufferzurück. Der Ausgabepuffer sollte eine STORAGE_HW_FIRMWARE_INFO und STORAGE_HW_FIRMWARE_SLOT_INFO Struktur für jeden Steckplatz auf dem Gerät enthalten.
Länge des Ausgabepuffers
Die Länge von .
Statusblock
Das Feld Information wird auf die Anzahl der zurückgegebenen Bytes festgelegt. Das Feld Status wird auf STATUS_SUCCESS oder möglicherweise auf STATUS_INVALID_DEVICE_REQUEST, STATUS_INVALID_PARAMETER oder STATUS_NOT_SUPPORTED festgelegt.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 10 |
mindestens unterstützte Server- | Windows Server 2016 |
Header- | ntddstor.h (include Ntddstor.h) |
Siehe auch
IOCTL_STORAGE_FIRMWARE_ACTIVATE
IOCTL_STORAGE_FIRMWARE_DOWNLOAD