структура 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