struktur STORAGE_HW_FIRMWARE_DOWNLOAD (winioctl.h)

Artikel
03/13/2024

Struktur ini berisi payload gambar firmware yang akan diunduh ke target.

Sintaks

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;

Anggota

Version

Versi struktur ini. Ini harus diatur ke sizeof(STORAGE_HW_FIRMWARE_DOWNLOAD).

Size

Ukuran struktur ini dan buffer gambar unduhan.

Flags

Bendera yang terkait dengan unduhan ini. Berikut ini adalah bendera valid yang dapat ditangguhkan oleh anggota ini.

Bendera	Deskripsi
STORAGE_HW_FIRMWARE_REQUEST_FLAG_CONTROLLER	Menunjukkan bahwa target permintaan adalah pengontrol atau adaptor, berbeda dari handler perangkat atau objek itu sendiri (misalnya NVMe SSD atau HBA).
STORAGE_HW_FIRMWARE_REQUEST_FLAG_LAST_SEGMENT	Menunjukkan bahwa segmen gambar firmware saat ini adalah yang terakhir.

Slot

Nomor slot tempat gambar firmware akan diunduh.

Reserved[3]

Disiapkan untuk penggunaan masa mendatang.

Offset

Offset dalam buffer ini di mana file Gambar dimulai. Ini harus diselaraskan ke ImagePayloadAlignment dari STORAGE_HW_FIRMWARE_INFO.

BufferSize

Ukuran buffer ImageBuffer. Ini harus menjadi kelipatan ImagePayloadAlignment dari STORAGE_HW_FIRMWARE_INFO.

ImageBuffer[ANYSIZE_ARRAY]

File gambar firmware.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Header	winioctl.h (termasuk Windows.h)