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

裝置上的韌體插槽數目。 這是 Slot 陣列的維度。

注意

有些裝置可以儲存超過 1 個韌體映射，如果有 1 個以上的韌體插槽。

ActiveSlot

包含目前作用中/執行中韌體映射的韌體位置。

PendingActivateSlot

擱置啟用的韌體位置。

FirmwareShared

指出韌體同時適用于裝置和控制器/介面卡，例如 NVMe SSD。

已保留

保留供未來使用。

ImagePayloadAlignment

影像承載的對齊方式，以位元組數為單位。 最大值為 PAGE_SIZE。 傳輸大小是這個大小的變動。 某些通訊協定至少需要磁區大小。 當此值設定為 0 時，這表示這個值無效。

ImagePayloadMaxSize

映射承載大小上限，用於單一命令。

位置

包含裝置上每個位置的插槽資訊，類型 為 STORAGE_HW_FIRMWARE_SLOT_INFO。

規格需求

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

另請參閱

IOCTL_STORAGE_FIRMWARE_ACTI加值稅E

STORAGE_HW_FIRMWARE_ACTI加值稅E

IOCTL_STORAGE_FIRMWARE_DOWNLOAD

STORAGE_HW_FIRMWARE_DOWNLOAD

IOCTL_STORAGE_FIRMWARE_GET_INFO

STORAGE_HW_FIRMWARE_INFO_QUERY

STORAGE_HW_FIRMWARE_SLOT_INFO