STORAGE_HW_FIRMWARE_DOWNLOAD構造体 (winioctl.h)

[アーティクル]
03/13/2024

この構造体には、ターゲットにダウンロードするファームウェアイメージペイロードが含まれています。

構文

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

このダウンロードに関連付けられているフラグ。このメンバーが保持できる有効なフラグを次に示します。

フラグ	説明
STORAGE_HW_FIRMWARE_REQUEST_FLAG_CONTROLLER	要求のターゲットがコントローラーまたはアダプターであり、デバイスハンドラーまたはオブジェクト自体 (NVMe SSD や HBA など) とは異なっていることを示します。
STORAGE_HW_FIRMWARE_REQUEST_FLAG_LAST_SEGMENT	現在のファームウェアイメージセグメントが最後のセグメントであることを示します。

Slot

ファームウェアイメージがダウンロードされるスロット番号。

Reserved[3]

将来利用するために予約されています。

Offset

イメージファイルの開始位置のこのバッファー内のオフセット。これは、STORAGE_HW_FIRMWARE_INFOから ImagePayloadAlignment に配置する必要があります。

BufferSize

ImageBuffer のバッファーサイズ。これは、STORAGE_HW_FIRMWARE_INFOからの ImagePayloadAlignment の倍数である必要があります。

ImageBuffer[ANYSIZE_ARRAY]

ファームウェアイメージファイル。

要件

要件	値
サポートされている最小のクライアント	Windows 10 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップアプリのみ]
Header	winioctl.h (Windows.h を含む)