struttura SP_NEWDEVICEWIZARD_DATA (setupapi.h)

Articolo
08/26/2023

Una struttura SP_NEWDEVICEWIZARD_DATA viene utilizzata dai programmi di installazione per estendere il funzionamento dell'installazione guidata dell'hardware aggiungendo pagine personalizzate. Viene usato con richieste di installazione DIF_NEWDEVICEWIZARD_XXX .

Sintassi

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;

Members

ClassInstallHeader

Intestazione della richiesta di installazione contenente le dimensioni dell'intestazione e il codice DIF per la richiesta. Vedere SP_CLASSINSTALL_HEADER.

Flags

Riservato. Deve essere zero.

DynamicPages[MAX_INSTALLWIZARD_DYNAPAGES]

Matrice di handle di pagina della finestra delle proprietà. Un programma di installazione può aggiungere gli handle delle pagine personalizzate della procedura guidata a questa matrice.

NumDynamicPages

Numero di pagine aggiunte alla matrice DynamicPages .

Poiché l'indice della matrice è in base zero, questo valore è anche l'indice alla voce libera successiva nella matrice. Ad esempio, se nella matrice sono presenti 3 pagine, DynamicPages[3] è la voce successiva da usare per un programma di installazione.

hwndWizardDlg

Handle per la finestra di primo livello dell'installazione guidata dell'hardware.