SP_INSTALLWIZARD_DATA

typedef struct _SP_INSTALLWIZARD_DATA {

SP_CLASSINSTALL_HEADER ClassInstallHeader;

DWORD Flags;

HPROPSHEETPAGE DynamicPages[MAX_INSTALLWIZARD_DYNAPAGES];

DWORD NumDynamicPages;

DWORD DynamicPageFlags;

DWORD PrivateFlags;

LPARAM PrivateData;

HWND hwndWizardDlg;

} SP_INSTALLWIZARD_DATA, *PSP_INSTALLWIZARD_DATA;

SP_INSTALLWIZARD_DATA is used by class installers to extend the operation of the hardware installation wizard by adding custom pages. It is used for both the DIF_INSTALLWIZARD and DIF_DESTROYWIZARDDATA install functions.

Members

ClassInstallHeader

Defines the class installation request for the install parameter structure.

Flags

These are internal flags used by the device installer.

DynamicPages

Contains an array of property sheet page handles. The class installer can use this array to create custom wizard pages and insert their handles into this array.

NumDynamicPages

The number of pages inserted into the DynamicPages array.

DynamicPageFlags

Flags that control the behavior of the installation wizard when dynamic pages have been added. Can be a combination of the following values:

DYNAWIZ_FLAG_PAGESADDED

Set by the hardware installation wizard if the class installer adds custom pages.

DYNAWIZ_FLAG_INSTALLDET_NEXT

If set, the hardware installation wizard allows the user to go forward from the Detected Devices page; otherwise, Finish is the default option for the Detected Devices page.

DYNAWIZ_FLAG_INSTALLDET_PREV

If set, the hardware installation wizard allows the user to go back from the Detected Devices page.

DYNAWIZ_FLAG_ANALYZE_HANDLECONFLICT

Set this flag if you jump to the Analyze page of the hardware installation wizard and want it to handle conflicts. Control will not be returned to the class installer if this flag is set and a conflict occurs.

The following flags are resource IDs for pre-defined pages of the hardware installation wizard:

IDD_DYNAWIZ_FIRSTPAGE

Resource ID for the first page that the hardware installation wizard will go to after adding the custom class installer pages.

IDD_DYNAWIZ_SELECT_PREVPAGE

Resource ID for the page that the Select Device page will go back to.

IDD_DYNAWIZ_SELECT_NEXTPAGE

Resource ID for the page that the Select Device page will go forward to.

IDD_DYNAWIZ_ANALYZE_PREVPAGE

Resource ID for the page that the Analyze dialog will go back to. This page is only used in the event that there is a problem and the user clicks on the Back button from the Analyze page.

IDD_DYNAWIZ_ANALYZE_NEXTPAGE

Resource ID for the page that the Analyze dialog will go to if it continues forward.

IDD_DYNAWIZ_INSTALLDETECTED_PREVPAGE

Resource ID for the page that the Install Detected Devices page will go back to.

IDD_DYNAWIZ_INSTALLDETECTED_NEXTPAGE

Resource ID for the page that the Install Detected Devices page will go forward to.

IDD_DYNAWIZ_INSTALLDETECTED_NODEVS

Resource ID for the page that the Install Detected Devices page will go to in the event that no devices are detected.

IDD_DYNAWIZ_SELECTDEV_PAGE

Resource ID of the hardware installation wizard's Select Device page.

IDD_DYNAWIZ_ANALYZEDEV_PAGE

Resource ID of the hardware installation wizard's Analyze page.

IDD_DYNAWIZ_INSTALLDETECTEDDEVS_PAGE

Resource ID of the hardware installation wizard's Install Detected Devices page.

IDD_DYNAWIZ_SELECTCLASS_PAGE

Resource ID of the hardware installation wizard's Select Class page.

PrivateFlags

Flags that can be defined and used by the class installer.

PrivateData

Pointer to private data defined and set by the class installer.

hwndWizardDlg

Window handle of the hardware installation wizard top-level window.

See Also

SetupDiGetWizardPage