Freigeben über


IOCTL_STORAGE_FIRMWARE_DOWNLOAD IOCTL (ntddstor.h)

Ein Treiber kann IOCTL_STORAGE_FIRMWARE_DOWNLOAD verwenden, um ein Firmwareimage auf ein Speichergerät herunterzuladen, aber es wird nicht aktiviert. Wenn das herunterzuladende Image größer als die maximale Datenübertragungsgröße des Controllers ist, muss diese IOCTL mehrmals aufgerufen werden, bis das gesamte Image heruntergeladen wird.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Irp->AssociatedIrp.SystemBuffer enthält STORAGE_HW_FIRMWARE_DOWNLOAD Daten, die Informationen über die zu aktivierende Firmware angeben.

Länge des Eingabepuffers

Parameters.DeviceIoControl.InputBufferLength gibt die Größe des Parameterpuffers in Bytes bei Irp->AssociatedIrp.SystemBuffer an, der >= sizeof(STORAGE_HW_FIRMWARE_DOWNLOAD) sein muss.

Ausgabepuffer

Diese IOCTL verfügt über keine Ausgabestruktur.

Länge des Ausgabepuffers

Keine.

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_INSUFFICIENT_RESOURCES festgelegt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Kopfzeile ntddstor.h (einschließen von Ntddstor.h)

Weitere Informationen

IOCTL_STORAGE_FIRMWARE_ACTIVATE

IOCTL_STORAGE_FIRMWARE_GET_INFO

STORAGE_HW_FIRMWARE_ACTIVATE

STORAGE_HW_FIRMWARE_DOWNLOAD

STORAGE_HW_FIRMWARE_INFO

STORAGE_HW_FIRMWARE_INFO_QUERY

STORAGE_HW_FIRMWARE_SLOT_INFO