SP_SELECTDEVICE_PARAMS_A structure (setupapi.h)
An SP_SELECTDEVICE_PARAMS structure corresponds to a DIF_SELECTDEVICE installation request.
Syntax
typedef struct _SP_SELECTDEVICE_PARAMS_A {
SP_CLASSINSTALL_HEADER ClassInstallHeader;
CHAR Title[MAX_TITLE_LEN];
CHAR Instructions[MAX_INSTRUCTION_LEN];
CHAR ListLabel[MAX_LABEL_LEN];
CHAR SubTitle[MAX_SUBTITLE_LEN];
BYTE Reserved[2];
} SP_SELECTDEVICE_PARAMS_A, *PSP_SELECTDEVICE_PARAMS_A;
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.
Reserved[2]
Reserved. For internal use only.
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.
![Screen shot of a Select a Device Driver dialog box](images/select-dialog.png)
Note
The setupapi.h header defines SP_SELECTDEVICE_PARAMS as an alias which 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 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) |