SP_NEWDEVICEWIZARD_DATA Struktur (setupapi.h)

Artikel
08/26/2023

Eine SP_NEWDEVICEWIZARD_DATA-Struktur wird von Installern verwendet, um den Betrieb des Hardwareinstallations-Assistenten zu erweitern, indem benutzerdefinierte Seiten hinzugefügt werden. Es wird mit DIF_NEWDEVICEWIZARD_XXX-Installationsanforderungen verwendet.

Syntax

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;

Member

ClassInstallHeader

Ein Installationsanforderungsheader, der die Headergröße und den DIF-Code für die Anforderung enthält. Siehe SP_CLASSINSTALL_HEADER.

Flags

Reserviert. Muss Null sein.

DynamicPages[MAX_INSTALLWIZARD_DYNAPAGES]

Ein Array von Eigenschaftenblattseitenhandles. Ein Installationsprogramm kann diesem Array die Handles von benutzerdefinierten Assistentenseiten hinzufügen.

NumDynamicPages

Die Anzahl der Seiten, die dem DynamicPages-Array hinzugefügt werden.

Da der Arrayindex nullbasiert ist, ist dieser Wert auch der Index für den nächsten freien Eintrag im Array. Wenn das Array beispielsweise 3 Seiten enthält, ist DynamicPages[3] der nächste Eintrag für ein Installationsprogramm, das verwendet werden soll.

hwndWizardDlg

Das Handle zum Fenster der obersten Ebene des Hardwareinstallations-Assistenten .