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

Флаги, связанные с этой загрузкой. Ниже приведены допустимые флаги, которые этот элемент может содержать.

Flag Описание
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. Это должно быть несколько значений ImagePayloadAlignment из STORAGE_HW_FIRMWARE_INFO.

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