SP_SELECTDEVICE_PARAMS_A 结构 (setupapi.h)

SP_SELECTDEVICE_PARAMS结构对应于 DIF_SELECTDEVICE 安装请求。

语法

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;

成员

ClassInstallHeader

一个安装请求标头，其中包含请求的标头大小和 DIF 代码。 请参阅 SP_CLASSINSTALL_HEADER。

Title[MAX_TITLE_LEN]

包含安装程序为驱动程序选择窗口提供的窗口标题的缓冲区。 Windows 将此标题用于“选择设备”对话框的窗口标题。

Instructions[MAX_INSTRUCTION_LEN]

包含安装程序提供的 select-device 指令的缓冲区。

ListLabel[MAX_LABEL_LEN]

包含安装程序提供的标签的缓冲区，该标签适用于用户可以从中选择的驱动程序列表。

SubTitle[MAX_SUBTITLE_LEN]

包含安装程序提供的字幕的缓冲区，该副标题用于选择设备向导。 选择对话框中不使用此字符串。

Reserved[2]

保留。 仅限内部使用。

注解

如果安装程序将此结构中的字段设置为在驱动程序选择期间使用，则安装程序还必须在SP_DEVINSTALL_PARAMS中设置DI_USECI_SELECTSTRINGS标志。

以下屏幕截图显示了一个示例“选择设备”对话框，并标识了安装程序可以提供的字符串。

注意

setupapi.h 标头将SP_SELECTDEVICE_PARAMS定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求	值
Header	setupapi.h (包括 Setupapi.h)

另请参阅

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice