STORAGE_HW_FIRMWARE_DOWNLOAD 结构 (winioctl.h)

此结构包含要下载到目标的固件映像有效负载。

语法

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

图像文件开始位置的此缓冲区中的偏移量。 这应与 STORAGE_HW_FIRMWARE_INFOImagePayloadAlignment 保持一致。

BufferSize

ImageBuffer 的缓冲区大小。 这应该是STORAGE_HW_FIRMWARE_INFO的 ImagePayloadAlignment 的倍数。

ImageBuffer[ANYSIZE_ARRAY]

固件映像文件。

要求

要求
最低受支持的客户端 Windows 10 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
标头 winioctl.h (包括 Windows.h)

另请参阅

IOCTL_STORAGE_FIRMWARE_ACTIVATE

IOCTL_STORAGE_FIRMWARE_DOWNLOAD

IOCTL_STORAGE_FIRMWARE_GET_INFO

STORAGE_HW_FIRMWARE_ACTIVATE

STORAGE_HW_FIRMWARE_INFO

STORAGE_HW_FIRMWARE_INFO_QUERY

STORAGE_HW_FIRMWARE_SLOT_INFO