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