DEVPKEY_DrvPkg_DocumentationLink设备属性表示设备实例文档的 URL。
Attribute | 值 |
---|---|
属性键 | DEVPKEY_DrvPkg_DocumentationLink |
Property-data-type identifier | DEVPROP_TYPE_STRING |
和 | 安装应用程序和安装程序的只读访问权限 |
本地化? | 是 |
注解
文档链接 URL 应是包含设备相关信息的文件的链接。 此属性旨在为设备提供 Web 可访问的文档。 文件可以是 HTML 页、 .pdf 文件、 .doc 文件或其他文件类型。 唯一的限制是,所有文档内容都必须包含在 URL 指定的文件中。 例如,自包含的 *.htm 文件有效,引用其他图形文件的 *.htm 文件无效,包含引用的图形文件的 *.mta Web 存档文件有效。
URL 可以包含参数。 例如,以下 URL 包含提供值“DSC530” 的 prod 参数、提供值“34”的 rev 参数和提供值“doc” 的类型 参数:
http://www.microsoft.com/redirect?prod=DSC530&rev=34&type=docs
Microsoft 不提供由 DEVPKEY_DrvPkg_DocumentationLink 属性值指定的网页的 Web 托管或重定向。 URL 必须链接到由 驱动程序包 提供程序维护的网页。
当用户单击安装程序生成的最终用户对话框中显示的网站链接时,Windows 会将以下信息添加到 HTTP 请求,其中包括 DEVPKEY_DrvPkg_DocumentationLink 提供的 URL:
由 pver 参数指定的 Windows 版本。 例如,“pver=6.0”指定 Windows Vista。
库存单位 (SKU) ,由 sbp 参数指定,可设置为 per 或 pro。 例如,“sbp=pro”指定专业版。
本地标识符 (lCID) ,由 olcid 参数指定。 例如,“olcid=0x409”指定英语 (标准) 语言。
设备最具体的硬件标识符,由 pnpid 参数指定。 例如,“pnpid=PCI%5CVEN_8086%26DEV_2533%26SUBSYS_00000000%26REV_04”指定 PCI 设备的硬件标识符。
出于隐私原因,HTTP 请求中不包含用户信息和设备的序列号。
The following example shows the type of HTTP request that would be sent to a web server: http://www.microsoft.com/redirect?prod=DSC530&rev34&type=docs&pver=6.0&spb=pro&olcid=0x409&pnpid=PCI%5CVEN_8086%26DEV_2533%26SUBSYS_00000000%26REV_04
可以通过 INF AddProperty 指令 设置DEVPKEY_DrvPkg_DocumentationLink的值,该指令包含在安装设备的 INF 文件的 INF DDInstall 节 中。 可以通过调用 SetupDiGetDeviceProperty 检索DEVPKEY_DrvPkg_DocumentationLinkproperty的值。
下面是一个示例,说明如何使用 INF AddProperty 指令为由 INF DDInstallSection 部分“SampleDDInstallSection ”安装的设备设置 DEVPKEY_DrvPkg_DocumentationLink 值:
[SampleDDinstallSection]
...
AddProperty=SampleAddPropertySection
...
[SampleAddPropertySection]
DeviceDocumentationLink,,,,"http://www.microsoft.com/redirect?prod=DSC530&rev34&type="docs"
...
要求
要求 | 说明 |
---|---|
版本 | 在 Windows Vista 和更高版本的 Windows 中可用。 |
标头 | Devpkey.h (包括 Devpkey.h) |