SP_DRVINSTALL_PARAMS 结构 (setupapi.h)

项目
08/26/2023

SP_DRVINSTALL_PARAMS 结构包含与特定驱动程序信息元素关联的驱动程序安装参数。

语法

typedef struct _SP_DRVINSTALL_PARAMS {
  DWORD     cbSize;
  DWORD     Rank;
  DWORD     Flags;
  DWORD_PTR PrivateData;
  DWORD     Reserved;
} SP_DRVINSTALL_PARAMS, *PSP_DRVINSTALL_PARAMS;

成员

cbSize

SP_DRVINSTALL_PARAMS结构的大小（以字节为单位）。

Rank

此驱动程序的排名匹配项。范围为 0 到 n，其中 0 是最兼容的。

Flags

控制在此驱动程序上运行的函数的标志。可以是以下各项的组合：

DNF_ALWAYSEXCLUDEFROMLIST (Windows Vista 及更高版本的 Windows)

如果设置了此标志，则无论执行枚举的客户端如何，此标志都会阻止枚举驱动程序节点。

DNF_AUTHENTICODE_SIGNED (Windows Server 2003 及更高版本的 Windows)

此驱动程序的 INF 文件由 Authenticode 签名进行签名。此标志对安装程序是只读的。

有关详细信息，请参阅使用 SetupAPI 验证驱动程序验证码签名。

DNF_BAD_DRIVER

请勿使用此驱动程序。安装程序可以读取和写入此标志。

如果设置了此标志， SetupDiSelectBestCompatDrv 和 SetupDiSelectDevice 将忽略此驱动程序。

类安装程序或共同安装程序可以设置此标志，以防止 Windows 在“选择驱动程序”对话框中列出驱动程序。例如，安装程序在处理 DIF_SELECTDEVICE 或 DIF_SELECTBESTCOMPATDRV 请求时可能会设置此标志。

DNF_BASIC_DRIVER (Windows XP 及更高版本的 Windows)

此驱动程序是基本驱动程序。此标志对安装程序是只读的。

DNF_CLASS_DRIVER

此驱动程序是类驱动程序。此标志对安装程序是只读的。

DNF_COMPATIBLE_DRIVER

此驱动程序是兼容的驱动程序。此标志对安装程序是只读的。

DNF_DUPDESC

其他提供驱动程序的提供程序具有与此驱动程序相同的说明。此标志对安装程序是只读的。

DNF_DUPDRIVERVER (Windows XP 及更高版本的 Windows)

其他提供驱动程序的提供程序具有与此驱动程序相同的版本。此标志对安装程序是只读的。

DNF_DUPPROVIDER

其他提供驱动程序的提供程序具有与此驱动程序相同的说明。此驱动程序与其匹配项之间的唯一区别是驱动程序日期。此标志对安装程序是只读的。

如果设置了此标志，Windows 会在驱动程序旁边显示驱动程序日期和驱动程序版本，以便用户可以将其与匹配项区分开来。

DNF_EXCLUDEFROMLIST

不要在任何驱动程序选择对话框中显示此驱动程序。

DNF_INBOX_DRIVER (Windows Vista 及更高版本的 Windows)

此驱动程序节点派生自此版本的 Windows 附带的 INF 文件。

DNF_INET_DRIVER

此驱动程序来自 Internet 或Windows 更新。此标志对安装程序是只读的。

如果调用 SetupCopyOEMInf ，则必须指定SPOST_URL标志，以便在 Windows 将此 INF 复制到 %SystemRoot%\inf 目录中时，Windows 会将它标记为 Internet INF。如果省略此步骤，Windows 将尝试使用此设备安装其他设备。由此产生的问题是，Windows 不再具有源文件，最终会提示用户路径无效。

DNF_INF_IS_SIGNED (Windows XP 及更高版本的 Windows)

此标志对安装程序是只读的，如果满足以下任一条件，则进行设置：

驱动程序具有 WHQL 发布签名。
驱动程序是收件箱驱动程序。
驱动程序具有 Authenticode 签名。

有关详细信息，请参阅驱动程序签名。

DNF_INSTALLEDDRIVER (Windows Vista 及更高版本的 Windows)

当前为设备安装了此驱动程序节点。此标志对安装程序是只读的。

DNF_LEGACYINF

此驱动程序来自旧版 INF 文件。此标志仅对基于 NT 的操作系统有效。此标志对安装程序是只读的。

DNF_NODRIVER

如果未为此逻辑驱动程序安装物理驱动程序，则设置。

DNF_OEM_F6_INF (Windows XP 及更高版本的 Windows)

保留。

DNF_OLD_INET_DRIVER

此驱动程序来自 Internet，但 Windows 当前无权访问其源文件。此标志对安装程序是只读的。

系统不会安装标有此标志的驱动程序，因为 Windows 没有源文件，最终会提示用户路径无效。此类驱动程序的 INF 可用于除安装设备之外的所有内容。

DNF_OLDDRIVER

此驱动程序当前/以前控制了关联的设备。此标志对安装程序是只读的。

DNF_REQUESTADDITIONALSOFTWARE (Windows 7 及更高版本的 Windows)

如果驱动程序包只是操作设备所需的软件解决方案的一部分，请设置此标志。在这种情况下，驱动程序包需要安装其他软件。

有关更多信息，请参见下面的“备注”部分。

PrivateData

类安装程序可用于存储私有数据的字段。共同安装程序不应使用此字段。

Reserved

保留。仅限内部使用。

注解

从 Windows 7 开始，安装程序或共同安装程序可以设置DNF_REQUESTADDITIONALSOFTWARE标志，以指示驱动程序包需要计算机中可能安装或未安装的其他软件。

安装设备的驱动程序包后，如果安装程序设置了DNF_REQUESTADDITIONALSOFTWARE标志，即插即用 (PnP) 管理器将执行以下步骤：

PnP 管理器使用 RequestAddtionalSoftware 类型生成问题报告和解决方案 (PRS) 错误报告。此报告包含有关设备的特定硬件 ID 和计算机的系统体系结构的信息。
如果有由独立硬件供应商 (IHV) 为特定于设备的软件提供的解决方案，则会将解决方案下载到计算机。
注意解决方案的下载不会安装软件本身。
如果计算机上未安装特定于设备的软件，则 PnP 管理器会向用户提供解决方案并提供用于下载软件的链接。然后，用户可以按照解决方案中提供的说明选择下载并安装此软件。

注意如果驱动程序包的 INF 文件已在 INF ControlFlags 节中设置了 RequestAdditionalSoftware 标志，则安装程序不必设置DNF_REQUESTADDITIONALSOFTWARE标志。

要求

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

另请参阅

SetupDiGetDriverInstallParams

SetupDiSetDriverInstallParams

通过