DEVPKEY_DrvPkg_Icon
Свойство устройства DEVPKEY_DrvPkg_Icon представляет список значков устройств, которые Windows использует для визуального представления экземпляра устройства.
| attribute | Значение |
|---|---|
| Ключ свойства | DEVPKEY_DrvPkg_Icon |
| Идентификатор типа данных свойства | DEVPROP_TYPE_STRING_LIST |
| Доступ к свойству | Доступ только для чтения с помощью установочных приложений и установщиков |
| Локализованные | Да |
Комментарии
Каждый значок в списке указывается путем к файлу значка (*.ico) или ссылкой на ресурс значка в исполняемом файле.
Первый значок в списке используется по умолчанию. Можно предоставить дополнительные значки, предоставляющие различные визуальные представления устройства. Windows включает пользовательский интерфейс, позволяющий пользователю выбрать значок, который отображается в Windows. Например, Microsoft DiscoveryCam 530 доступен в синем, зеленом и красном цветах. Корпорация Майкрософт предоставляет значок для каждого цвета. Windows использует синий значок по умолчанию, так как он является первым в списке. Однако пользователи Windows также могут выбрать зеленый или красный значок.
Список значков представляет собой разделенный null список описателей значков. Описатель значка — это путь к файлу значка (*.ico) или описатель icon-resource, как показано ниже.
Формат пути к файлу значка — DirectoryPath\имя_файла.ico.
Описатель icon-resource содержит следующие записи:
@executable-file-path,resource-identifierПервым символом описатель icon-resource является знак at (@), за которым следует путь к исполняемому файлу ( файл *.exe или *.dll ), за которым следует разделитель запятых (,), а затем запись resource-identifier .
Например, описатель значка "@shell32.dll,-30" представляет исполняемый файл "shell32.dll" и идентификатор ресурса "-30".
Идентификатор ресурса должен быть целочисленным значением, которое соответствует ресурсу в исполняемом файле следующим образом:
Если предоставленный идентификатор отрицательный, Windows использует ресурс в исполняемом файле, идентификатор которого равен абсолютному значению предоставленного идентификатора.
Если предоставленный идентификатор равен нулю, Windows использует ресурс в исполняемом файле, идентификатор которого имеет наименьшее значение в исполняемом файле.
Если предоставленный идентификатор является положительным, например значение n, Windows использует ресурс в исполняемом файле, идентификатор которого является n+1 наименьшим значением в исполняемом файле. Например, если значение n равно 1, Windows использует ресурс, идентификатор которого имеет второе наименьшее значение в исполняемом файле.
Значение DEVPKEY_DrvPkg_Icon можно задать директивой INF AddProperty, которая включена в раздел INF DDInstall INF-файла, устанавливающего устройство. Значение DEVPKEY_DrvPkg_Icon можно получить, вызвав CM_Get_DevNode_Property или SetupDiGetDeviceProperty.
Ниже приведен пример использования директивы INF AddProperty для установки DEVPKEY_DrvPkg_Icon для устройства, установленного с помощью раздела INF DDInstall "SampleDDInstallSection".
[SampleDDinstallSection]
...
AddProperty=SampleAddPropertySection
...
[SampleAddPropertySection]
DeviceIcon,,,,"SomeResource.dll,-2","SomeIcon.icon"
...
Требования
Версия: Windows Vista и более поздние версии Windows
Заголовок: Devpkey.h (включая Devpkey.h)