DEVPKEY_DrvPkg_Icon

The DEVPKEY_DrvPkg_Icon device property represents a list of device icons that Windows uses to visually represent a device instance.

Property key

DEVPKEY_DrvPkg_Icon

Property-data-type identifier

DEVPROP_TYPE_STRING_LIST

Property access

Read-only access by installation applications and installers

Localized?

Yes

 

Remarks

Each icon in the list is specified by a path of an icon file (*.ico) or a reference to an icon resource in an executable file.

The first icon in the list is used as the default. Additional icons can be supplied that provide different visual representations of a device. Windows includes a user interface that allows a user to select which icon Windows displays. For example, the Microsoft DiscoveryCam 530 is available in blue, green, and red. Microsoft supplies an icon for each color. Windows uses the blue icon by default because it is the first one in the list. However, Windows users can also choose the green icon or the red icon.

The icon list is a NULL-separated list of icon specifiers. An icon specifier is either a path of an icon file (*.ico) or an icon-resource specifier, as follows:

  • The format of the path to an icon file is DirectoryPath\filename.ico.

  • An icon-resource specifier has the following entries:

    
    @executable-file-path,resource-identifier
    
    

    The first character of icon-resource specifier is the at sign (@) followed by the path of an executable file (an *.exe or a *.dll file), followed by a comma separator (,), and then the resource-identifier entry.

For example, the icon specifier"@shell32.dll,-30" represents the executable file "shell32.dll" and the resource identifier "-30".

A resource identifier must be an integer value, which corresponds to a resource within the executable file, as follows:

  • If the supplied identifier is negative, Windows uses the resource in the executable file whose identifier is equal to the absolute value of the supplied identifier.

  • If the supplied identifier is zero, Windows uses the resource in the executable file whose identifier has the lowest value in the execuable file.

  • If the supplied identifier is positive, for example, the value n, Windows uses the resource in the executable file whose identifier is the n+1 lowest value in the executable file. For example, if the value of n is 1, Windows uses the resource whose identifier has the second lowest value in the executable file.

You can set the value of DEVPKEY_DrvPkg_Icon by an INF AddProperty directive that is included in the INF DDInstall section of the INF file that installs the device. You can retrieve the value of DEVPKEY_DrvPkg_Icon by calling SetupDiGetDeviceProperty.

The following is an example of how to use an INF AddProperty directive to set DEVPKEY_DrvPkg_Icon for a device that is installed by an INF DDInstall section "SampleDDInstallSection":


[SampleDDinstallSection]
...
AddProperty=SampleAddPropertySection
...

[SampleAddPropertySection] 
DeviceIcon,,,,"SomeResource.dll,-2","SomeIcon.icon"
...

Requirements

Version

Available in Windows Vista and later versions of Windows.

Header

Devpkey.h (include Devpkey.h)

See also

INF AddProperty Directive
INF DDInstall Section
SetupDiGetDeviceProperty

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft