estrutura STORAGE_HW_FIRMWARE_ACTIVATE (winioctl.h)

Essa estrutura contém informações sobre o firmware baixado a ser ativado.

Sintaxe

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;

Membros

Version

A versão dessa estrutura. Isso deve ser definido como sizeof(STORAGE_HW_FIRMWARE_ACTIVATE).

Size

O tamanho dessa estrutura. Isso deve ser definido como sizeof(STORAGE_HW_FIRMWARE_ACTIVATE).

Flags

Os sinalizadores associados à solicitação de ativação. Veja a seguir os sinalizadores válidos que podem ser definidos neste membro.

Bandeira	Descrição
STORAGE_HW_FIRMWARE_REQUEST_FLAG_CONTROLLER	Indica que o destino da solicitação é um controlador ou adaptador, diferente do próprio identificador ou objeto do dispositivo (por exemplo, SSD de NVMe ou HBA).
STORAGE_HW_FIRMWARE_REQUEST_FLAG_SWITCH_TO_EXISTING_FIRMWARE	Indica que a imagem de firmware existente no slot especificado deve ser ativada.
STORAGE_HW_FIRMWARE_REQUEST_FLAG_REPLACE_EXISTING_IMAGE	com suporte no Windows 11, versão 24H2 e posterior. Indica que o firmware existente no slot deve ser ativado com uma redefinição do controlador.

Slot

O slot com a imagem de firmware que deve ser ativada.

Reserved0[3]

Reservado para uso futuro.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2016 [somente aplicativos da área de trabalho]
cabeçalho	winioctl.h (inclua Windows.h)