SP_NEWDEVICEWIZARD_DATA structure (setupapi.h)

An SP_NEWDEVICEWIZARD_DATA structure is used by installers to extend the operation of the hardware installation wizard by adding custom pages. It is used with DIF_NEWDEVICEWIZARD_XXX installation requests.

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;

Members

ClassInstallHeader

An install request header that contains the header size and the DIF code for the request. See SP_CLASSINSTALL_HEADER.

Flags

Reserved. Must be zero.

DynamicPages[MAX_INSTALLWIZARD_DYNAPAGES]

An array of property sheet page handles. An installer can add the handles of custom wizard pages to this array.

NumDynamicPages

The number of pages that are added to the DynamicPages array.

Because the array index is zero-based, this value is also the index to the next free entry in the array. For example, if there are 3 pages in the array, DynamicPages[3] is the next entry for an installer to use.

hwndWizardDlg

The handle to the top-level window of the hardware installation wizard .

Remarks

SP_ADDPROPERTYPAGE_DATA is an alias for this structure.

Requirements

Requirement Value
Header setupapi.h (include Setupapi.h)

See also

DIF_NEWDEVICEWIZARD_FINISHINSTALL

DIF_NEWDEVICEWIZARD_POSTANALYZE

DIF_NEWDEVICEWIZARD_PREANALYZE

DIF_NEWDEVICEWIZARD_PRESELECT

DIF_NEWDEVICEWIZARD_SELECT