DEVPKEY_DrvPkg_Icon

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

Attribute Value
属性键 DEVPKEY_DrvPkg_Icon
属性数据类型标识符 DEVPROP_TYPE_STRING_LIST
和 安装应用程序和安装程序的只读访问权限
本地化 Yes

Remarks

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

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

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

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

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

    @executable-file-path,resource-identifier
    

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

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

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

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

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

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

可以通过安装设备的 INF 文件的 INF DDInstall 节中包含的 INF AddProperty 指令来设置DEVPKEY_DrvPkg_Icon的值。 可以通过调用 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