structure STORAGE_HW_FIRMWARE_DOWNLOAD (winioctl.h)

  • Article

Cette structure contient une charge utile d’image du microprogramme à télécharger sur la cible.

Syntaxe

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;

Membres

Version

Version de cette structure. Cette valeur doit être définie sur sizeof(STORAGE_HW_FIRMWARE_DOWNLOAD).

Size

Taille de cette structure et de la mémoire tampon d’image de téléchargement.

Flags

Indicateurs associés à ce téléchargement. Voici les indicateurs valides que ce membre peut contenir.

Indicateur Description
STORAGE_HW_FIRMWARE_REQUEST_FLAG_CONTROLLER Indique que la cible de la requête est un contrôleur ou un adaptateur, différent du gestionnaire d’appareil ou de l’objet lui-même (par exemple, SSD NVMe ou HBA).
STORAGE_HW_FIRMWARE_REQUEST_FLAG_LAST_SEGMENT Indique que le segment d’image du microprogramme actuel est le dernier.

Slot

Numéro d’emplacement sur lequel l’image du microprogramme sera téléchargée.

Reserved[3]

Réservé pour un usage futur.

Offset

Décalage dans cette mémoire tampon de l’emplacement où commence le fichier Image. Il doit être aligné sur ImagePayloadAlignment à partir de STORAGE_HW_FIRMWARE_INFO.

BufferSize

Taille de la mémoire tampon de l’ImageBuffer. Il doit s’agir d’un multiple de ImagePayloadAlignment de STORAGE_HW_FIRMWARE_INFO.

ImageBuffer[ANYSIZE_ARRAY]

Fichier image du microprogramme.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
En-tête winioctl.h (inclure Windows.h)

Voir aussi

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