DEVPKEY_DeviceDisplay_Category

The DEVPKEY_DeviceDisplay_Category device property represents one or more functional categories that apply to a device instance.

Property key

DEVPKEY_DeviceDisplay_Category

Property-data-type identifier

DEVPROP_TYPE_STRING_LIST

Property access

Read-only access by installation applications and installers.

Localized?

No

 

Remarks

Device categories for a physical device are specified through the DeviceCategory XML element in a device metadata package. Each instance of that device in a system inherits the device categories for that physical device.

Each physical device can have one or more functional categories specified in the device metadata package. Each category is used by Windows Devices and Printers to group the device instance into one of the recognized device categories.

Multifunction devices would typically identify multiple functional categories for each hardware function that the device supports. For example, a multifunction device could identify functional categories for printer, fax, scanner, and removable storage device functionality.

The first functional category string in the DEVPROP_TYPE_STRING_LIST specifies the physical device's primary functional category. The primary functional category is defined by the independent hardware vendor (IHV) to specify how the device is advertised, packaged, sold, and ultimately identified by users.

If the DEVPKEY_DeviceDisplay_Category device property specifies more than one functional category string, the remaining strings that follow the first string specifies the physical device's secondary functional categories.

The Devices and Printers user interface in Control Panel displays the primary and secondary functional categories of the device instance. These categories are displayed in the order that is specified in the DEVPKEY_DeviceDisplay_Category device property.

You can access the DEVPKEY_DeviceDisplay_Category property by calling SetupDiGetDeviceProperty.

Requirements

Version

Available in Windows 7 and later versions of Windows.

Header

Devpkey.h (include Devpkey.h)

See also

DeviceCategory
SetupDiGetDeviceProperty

 

 

Send comments about this topic to Microsoft

Show: