SP_SELECTDEVICE_PARAMS_W structure (setupapi.h)
An SP_SELECTDEVICE_PARAMS structure corresponds to a DIF_SELECTDEVICE installation request.
Syntax
typedef struct _SP_SELECTDEVICE_PARAMS_W {
SP_CLASSINSTALL_HEADER ClassInstallHeader;
WCHAR Title[MAX_TITLE_LEN];
WCHAR Instructions[MAX_INSTRUCTION_LEN];
WCHAR ListLabel[MAX_LABEL_LEN];
WCHAR SubTitle[MAX_SUBTITLE_LEN];
} SP_SELECTDEVICE_PARAMS_W, *PSP_SELECTDEVICE_PARAMS_W;
Members
ClassInstallHeader
An install request header that contains the header size and the DIF code for the request. See SP_CLASSINSTALL_HEADER.
Title[MAX_TITLE_LEN]
Buffer that contains an installer-provided window title for driver-selection windows. Windows uses this title for the window title for the Select Device dialogs.
Instructions[MAX_INSTRUCTION_LEN]
Buffer that contains an installer-provided select-device instructions.
ListLabel[MAX_LABEL_LEN]
Buffer that contains an installer-provided label for the list of drivers from which the user can select.
SubTitle[MAX_SUBTITLE_LEN]
Buffer that contains an installer-provided subtitle used in select-device wizards. This string is not used in select dialogs.
Remarks
If an installer sets fields in this structure to be used during driver selection, the installer must also set the DI_USECI_SELECTSTRINGS flag in the SP_DEVINSTALL_PARAMS.
The following screen shot shows a sample Select Device dialog box and identifies the strings an installer can supply.
Note
The setupapi.h header defines SP_SELECTDEVICE_PARAMS as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
| Requirement | Value |
|---|---|
| Header | setupapi.h (include Setupapi.h) |