struttura STORAGE_HW_FIRMWARE_DOWNLOAD (winioctl.h)

Articolo
03/13/2024

Questa struttura contiene un payload dell'immagine del firmware da scaricare nella destinazione.

Sintassi

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;

Members

Version

Versione di questa struttura. Deve essere impostato su sizeof(STORAGE_HW_FIRMWARE_DOWNLOAD).

Size

Dimensioni di questa struttura e del buffer dell'immagine di download.

Flags

Flag associati a questo download. Di seguito sono riportati flag validi che il membro può contenere.

Flag	Descrizione
STORAGE_HW_FIRMWARE_REQUEST_FLAG_CONTROLLER	Indica che la destinazione della richiesta è un controller o un adattatore diverso dal gestore del dispositivo o dall'oggetto stesso ,ad esempio unità SSD NVMe o HBA.
STORAGE_HW_FIRMWARE_REQUEST_FLAG_LAST_SEGMENT	Indica che il segmento di immagine del firmware corrente è l'ultimo.

Slot

Numero di slot in cui verrà scaricata l'immagine del firmware.

Reserved[3]

Riservato per utilizzi futuri.

Offset

Offset in questo buffer in cui inizia il file Image. Deve essere allineato a ImagePayloadAlignment da STORAGE_HW_FIRMWARE_INFO.

BufferSize

Dimensioni del buffer dell'oggetto ImageBuffer. Deve trattarsi di un multiplo di ImagePayloadAlignment da STORAGE_HW_FIRMWARE_INFO.

ImageBuffer[ANYSIZE_ARRAY]

File di immagine del firmware.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Intestazione	winioctl.h (include Windows.h)