STORAGE_HW_FIRMWARE_DOWNLOAD-Struktur (winioctl.h)
Enthält eine Nutzlast des Firmware-Images, die in das Ziel heruntergeladen werden soll.
Syntax
typedef struct _STORAGE_HW_FIRMWARE_DOWNLOAD {
DWORD Version;
DWORD Size;
DWORD Flags;
BYTE Slot;
BYTE Reserved[3];
DWORDLONG Offset;
DWORDLONG BufferSize;
BYTE ImageBuffer[ANYSIZE_ARRAY];
} STORAGE_HW_FIRMWARE_DOWNLOAD, *PSTORAGE_HW_FIRMWARE_DOWNLOAD;
Member
Version
Die Version dieser Struktur. Dies sollte auf sizeof(STORAGE_HW_FIRMWARE_DOWNLOAD) festgelegt werden.
Size
Die Größe dieser Struktur und des Downloadimagepuffers.
Flags
Diesem Download zugeordnete Flags. Im Folgenden sind gültige Flags aufgeführt, die dieser Member enthalten kann.
| Flag | Beschreibung |
|---|---|
| STORAGE_HW_FIRMWARE_REQUEST_FLAG_CONTROLLER | Gibt an, dass das Ziel der Anforderung ein Controller oder Adapter ist, der sich vom Gerätehandler oder Objekt selbst unterscheidet (z. B. NVMe SSD oder HBA). |
| STORAGE_HW_FIRMWARE_REQUEST_FLAG_LAST_SEGMENT | Gibt an, dass das aktuelle Firmwareimagesegment das letzte ist. |
Slot
Die Slotnummer, in die das Firmwareimage heruntergeladen wird.
Reserved[3]
Für die zukünftige Verwendung reserviert.
Offset
Der Offset in diesem Puffer, an dem die Imagedatei beginnt. Dies sollte von STORAGE_HW_FIRMWARE_INFO an ImagePayloadAlignment ausgerichtet werden.
BufferSize
Die Puffergröße des ImageBuffers. Dies sollte ein Vielfaches von ImagePayloadAlignment aus STORAGE_HW_FIRMWARE_INFO sein.
ImageBuffer[ANYSIZE_ARRAY]
Die Firmwareimagedatei.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Kopfzeile | winioctl.h (windows.h einschließen) |
Weitere Informationen
IOCTL_STORAGE_FIRMWARE_ACTIVATE
IOCTL_STORAGE_FIRMWARE_DOWNLOAD
IOCTL_STORAGE_FIRMWARE_GET_INFO