通过

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]

包含安装程序提供的选择设备指令的缓冲区。

ListLabel[MAX_LABEL_LEN]

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

SubTitle[MAX_SUBTITLE_LEN]

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

Reserved[2]

保留。 仅供内部使用。

言论

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

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

“选择设备驱动程序”对话框的屏幕截图

注意

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

要求

要求 价值
标头 setupapi.h （包括 Setupapi.h）

另请参阅

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice