Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This structure contains information about the downloaded firmware to activate.
Syntax
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;
Members
Version
The version of this structure. This should be set to sizeof(STORAGE_HW_FIRMWARE_ACTIVATE).
Size
The size of this structure. This should be set to sizeof(STORAGE_HW_FIRMWARE_ACTIVATE).
Flags
The flags associated with the activation request. The following are valid flags that can be set in this member.
| Flag | Description |
|---|---|
| STORAGE_HW_FIRMWARE_REQUEST_FLAG_CONTROLLER | Indicates that the target of the request is a controller or adapter, different than the device handle or object itself (e.g. NVMe SSD or HBA). |
| STORAGE_HW_FIRMWARE_REQUEST_FLAG_SWITCH_TO_EXISTING_FIRMWARE | Indicates that the existing firmware image in the specified slot should be activated. |
| STORAGE_HW_FIRMWARE_REQUEST_FLAG_REPLACE_EXISTING_IMAGE | Supported in Windows 11, version 24H2, and later. Indicates that the existing firmware in the slot should be activated with a controller reset. |
Slot
The slot with the firmware image that is to be activated.
Reserved0[3]
Reserved for future use.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10 [desktop apps only] |
| Minimum supported server | Windows Server 2016 [desktop apps only] |
| Header | winioctl.h (include Windows.h) |
See also
IOCTL_STORAGE_FIRMWARE_ACTIVATE
IOCTL_STORAGE_FIRMWARE_DOWNLOAD
IOCTL_STORAGE_FIRMWARE_GET_INFO