SP_SELECTDEVICE_PARAMS structure

An SP_SELECTDEVICE_PARAMS structure corresponds to a DIF_SELECTDEVICE installation request.

Syntax


typedef struct _SP_SELECTDEVICE_PARAMS {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  TCHAR                  Title[MAX_TITLE_LEN];
  TCHAR                  Instructions[MAX_INSTRUCTION_LEN];
  TCHAR                  ListLabel[MAX_LABEL_LEN];
  TCHAR                  SubTitle[MAX_SUBTITLE_LEN];
  BYTE                   Reserved[2];
} SP_SELECTDEVICE_PARAMS, *PSP_SELECTDEVICE_PARAMS;

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
SetupDiCallClassInstaller
SetupDiSelectDevice
SP_CLASSINSTALL_HEADER

 

 

Send comments about this topic to Microsoft

Show: