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.

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