STORAGE_HW_FIRMWARE_INFO 结构

  • 项目

此结构包含有关设备固件的信息。

语法

typedef struct _STORAGE_HW_FIRMWARE_INFO {
  DWORD                         Version;
  DWORD                         Size;
  BYTE                          SupportUpgrade  :1;
  BYTE                          Reserved0  :7;
  BYTE                          SlotCount;
  BYTE                          ActiveSlot;
  BYTE                          PendingActivateSlot;
  BOOLEAN                       FirmwareShared;
  BYTE                          Reserved[3];
  DWORD                         ImagePayloadAlignment;
  DWORD                         ImagePayloadMaxSize;
  STORAGE_HW_FIRMWARE_SLOT_INFO Slot[ANYSIZE_ARRAY];
} STORAGE_HW_FIRMWARE_INFO, *PSTORAGE_HW_FIRMWARE_INFO;

成员

版本

此结构的版本。 这应设置为 sizeof (STORAGE_HW_FIRMWARE_INFO)

大小

此结构作为缓冲区（包括槽）的大小。

SupportUpgrade

指示此固件支持升级。

Reserved0

保留供将来使用。

SlotCount

设备上的固件插槽数。 这是槽数组的维度。

注意

如果某些设备具有 1 个以上的固件插槽，则可以存储 1 个以上的固件映像。

ActiveSlot

包含当前活动/正在运行的固件映像的固件槽。

PendingActivateSlot

正在等待激活的固件槽。

FirmwareShared

指示固件同时应用于设备和控制器/适配器，例如 NVMe SSD。

Reserved

保留供将来使用。

ImagePayloadAlignment

图像有效负载的对齐方式（以字节数为单位）。 最大值为PAGE_SIZE。 传输大小是此大小的多变。 某些协议至少需要扇区大小。 如果此值设置为 0，则表示此值无效。

ImagePayloadMaxSize

图像有效负载最大大小，用于单个命令。

槽位

包含设备上每个槽的槽信息，类型 为 STORAGE_HW_FIRMWARE_SLOT_INFO。

要求

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

请参阅

IOCTL_STORAGE_FIRMWARE_ACTIVATE

STORAGE_HW_FIRMWARE_ACTIVATE

IOCTL_STORAGE_FIRMWARE_DOWNLOAD

STORAGE_HW_FIRMWARE_DOWNLOAD

IOCTL_STORAGE_FIRMWARE_GET_INFO

STORAGE_HW_FIRMWARE_INFO_QUERY

STORAGE_HW_FIRMWARE_SLOT_INFO