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 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)

See also

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice