DEVPKEY_DrvPkg_Icon

DEVPKEY_DrvPkg_Icon设备属性表示 Windows 用于直观表示设备实例的设备图标列表。

Attribute
属性键 DEVPKEY_DrvPkg_Icon
Property-data-type identifier DEVPROP_TYPE_STRING_LIST
安装应用程序和安装程序的只读访问权限
翻译词汇

注解

列表中的每个图标都由图标文件 (*.ico) 的路径或可执行文件中对图标资源的引用指定。

列表中的第一个图标用作默认值。 可以提供其他图标来提供设备的不同视觉表示形式。 Windows 包含一个用户界面,允许用户选择 Windows 显示的图标。 例如,Microsoft DiscoveryCam 530 提供蓝色、绿色和红色。 Microsoft 为每个颜色提供一个图标。 Windows 默认使用蓝色图标,因为它是列表中的第一个图标。 但是,Windows 用户还可以选择绿色图标或红色图标。

图标列表是一个以 NULL 分隔的图标说明符列表。 图标说明符是图标文件的路径 (*.ico) 或图标资源说明符,如下所示:

  • 图标文件的路径格式为 DirectoryPath\filename.ico。

  • 图标资源说明符具有以下条目:

    @executable-file-path,resource-identifier
    

    icon-resource 说明符的第一个字符是 at 符号 (@) 后跟可执行文件的路径 (*.exe*.dll 文件) ,后跟逗号分隔符 (,) ,然后 是资源标识符 条目。

例如,图标说明符“@shell32.dll,-30”表示可执行文件“shell32.dll”和资源标识符“-30”。

资源标识符必须是一个整数值,该值对应于可执行文件中的资源,如下所示:

  • 如果提供的标识符为负值,则 Windows 将使用可执行文件中的资源,其标识符等于所提供的标识符的绝对值。

  • 如果提供的标识符为零,则 Windows 将使用可执行文件中的资源,其标识符在可执行文件中具有最低值。

  • 如果提供的标识符为正值,例如值 n,则 Windows 将使用可执行文件中的资源,其标识符为可执行文件中的 n+1 最小值。 例如,如果 n 的值为 1,则 Windows 将使用其标识符在可执行文件中具有第二最低值的资源。

可以通过 INF AddProperty 指令 设置 DEVPKEY_DrvPkg_Icon 的值,该指令包含在安装设备的 INF 文件的 INF DDInstall 中。 可以通过调用 CM_Get_DevNode_Property 或 SetupDiGetDeviceProperty 来检索DEVPKEY_DrvPkg_Icon的值。

下面是如何使用 INF AddProperty 指令为 INF DDInstall 节“SampleDDInstallSection ”安装的设备设置DEVPKEY_DrvPkg_Icon的示例:

[SampleDDinstallSection]
...
AddProperty=SampleAddPropertySection
...

[SampleAddPropertySection] 
DeviceIcon,,,,"SomeResource.dll,-2","SomeIcon.icon"
...

要求

版本:Windows Vista 和更高版本的 Windows

标头:Devpkey.h (包括 Devpkey.h)

另请参阅

INF AddProperty 指令

INF DDInstall

SetupDiGetDeviceProperty