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