_SP_SELECTDEVICE_PARAMS_A structure

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

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

Buffer that contains an installer-provided select-device instructions.

ListLabel

Buffer that contains an installer-provided label for the list of drivers from which the user can select.

SubTitle

Buffer that contains an installer-provided subtitle used in select-device wizards. This string is not used in select dialogs.

Reserved

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

Requirements

   
Header setupapi.h (include Setupapi.h)

See Also

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice