STORAGE_HW_FIRMWARE_DOWNLOAD結構 (winioctl.h)

發行項
03/04/2024

此結構包含要下載至目標的韌體映像承載。

語法

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;

成員

Version

這個結構的版本。這應該設定為sizeof (STORAGE_HW_FIRMWARE_DOWNLOAD) 。

Size

這個結構和下載映像緩衝區的大小。

Flags

與此下載相關聯的旗標。以下是這個成員可以保留的有效旗標。

旗標	描述
STORAGE_HW_FIRMWARE_REQUEST_FLAG_CONTROLLER	指出要求的目標是控制器或適配卡，不同於裝置處理程式或物件本身 (例如 NVMe SSD 或 HBA) 。
STORAGE_HW_FIRMWARE_REQUEST_FLAG_LAST_SEGMENT	表示目前的韌體映射區段是最後一個。

Slot

將下載韌體映像的插槽編號。

Reserved[3]

保留供未來使用。

Offset

此緩衝區中 Image 檔案開始的位置位移。這應該與 imagePayloadAlignment 對齊 STORAGE_HW_FIRMWARE_INFO。

BufferSize

ImageBuffer 的緩衝區大小。這應該是來自 STORAGE_HW_FIRMWARE_INFO的 ImagePayloadAlignment 的倍數。

ImageBuffer[ANYSIZE_ARRAY]

韌體映像檔。

規格需求

需求	值
最低支援的用戶端	Windows 10 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2016 [僅限傳統型應用程式]
標頭	winioctl.h (包含 Windows.h)