STORAGE_HW_FIRMWARE_ACTIVATE結構（winioctl.h）

發行項
11/20/2024

此結構包含要啟動之下載韌體的相關信息。

語法

typedef struct _STORAGE_HW_FIRMWARE_ACTIVATE {
  DWORD Version;
  DWORD Size;
  DWORD Flags;
  BYTE  Slot;
  BYTE  Reserved0[3];
} STORAGE_HW_FIRMWARE_ACTIVATE, *PSTORAGE_HW_FIRMWARE_ACTIVATE;

成員

Version

這個結構的版本。這應該設定為sizeof（STORAGE_HW_FIRMWARE_ACTIVATE）。

Size

這個結構的大小。這應該設定為sizeof（STORAGE_HW_FIRMWARE_ACTIVATE）。

Flags

與啟用要求相關聯的旗標。以下是可在這個成員中設定的有效旗標。

旗	描述
STORAGE_HW_FIRMWARE_REQUEST_FLAG_CONTROLLER	表示要求的目標是控制器或適配卡，不同於裝置句柄或物件本身（例如 NVMe SSD 或 HBA）。
STORAGE_HW_FIRMWARE_REQUEST_FLAG_SWITCH_TO_EXISTING_FIRMWARE	表示應該啟動指定位置中的現有韌體映像。
STORAGE_HW_FIRMWARE_REQUEST_FLAG_REPLACE_EXISTING_IMAGE	Windows 11 版本 24H2 和更新版本中支援。指出位置中現有的韌體應該以控制器重設來啟動。

Slot

具有要啟動之韌體映像的位置。

Reserved0[3]

保留供日後使用。

要求

要求	價值
最低支援的用戶端	Windows 10 [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2016 [僅限傳統型應用程式]
標頭	winioctl.h （包括 Windows.h）