DEVPKEY_DrvPkg_Icon

Свойство устройства DEVPKEY_DrvPkg_Icon представляет список значков устройств, которые Windows используются для визуального представления экземпляра устройства.

Attribute Value
Ключ свойства DEVPKEY_DrvPkg_Icon
Идентификатор типа property-data 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
    

    Первым символом описатель ресурса значка является знак (@), за которым следует путь исполняемого файла ( файл *.exe или *.dll ), за которым следует разделитель запятых (,), а затем запись идентификатора ресурса .

Например, описатель значка"@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"
...

Requirements

Версия: Windows Vista и более поздние версии Windows

Заголовок: Devpkey.h (включить Devpkey.h)

См. также

Директива INF AddProperty

Раздел INF DDInstall

SetupDiGetDeviceProperty