estrutura SP_NEWDEVICEWIZARD_DATA (setupapi.h)

Artigo
08/26/2023

Uma estrutura SP_NEWDEVICEWIZARD_DATA é usada pelos instaladores para estender a operação do assistente de instalação de hardware adicionando páginas personalizadas. Ele é usado com solicitações de instalação DIF_NEWDEVICEWIZARD_XXX .

Sintaxe

typedef struct _SP_NEWDEVICEWIZARD_DATA {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  DWORD                  Flags;
  HPROPSHEETPAGE         DynamicPages[MAX_INSTALLWIZARD_DYNAPAGES];
  DWORD                  NumDynamicPages;
  HWND                   hwndWizardDlg;
} SP_NEWDEVICEWIZARD_DATA, *PSP_NEWDEVICEWIZARD_DATA;

Membros

ClassInstallHeader

Um cabeçalho de solicitação de instalação que contém o tamanho do cabeçalho e o código DIF da solicitação. Consulte SP_CLASSINSTALL_HEADER.

Flags

Reservado. Deve ser zero.

DynamicPages[MAX_INSTALLWIZARD_DYNAPAGES]

Uma matriz de identificadores de página de folha de propriedades. Um instalador pode adicionar os identificadores de páginas de assistente personalizadas a essa matriz.

NumDynamicPages

O número de páginas adicionadas à matriz DynamicPages .

Como o índice de matriz é baseado em zero, esse valor também é o índice para a próxima entrada gratuita na matriz. Por exemplo, se houver três páginas na matriz, DynamicPages[3] será a próxima entrada para um instalador usar.

hwndWizardDlg

O identificador para a janela de nível superior do assistente de instalação de hardware .