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)