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)