DEVPKEY_Device_FriendlyName

The DEVPKEY_Device_FriendlyName device property represents the friendly name of a device instance.

Attribute Value

Property key

DEVPKEY_Device_FriendlyName

Property-data-type identifier

DEVPROP_TYPE_STRING

Property access

Read and write access by installation applications and installers

Corresponding SPDRP_Xxx identifier

SPDRP_FRIENDLYNAME

Localized?

No

Remarks

You can use the DEVPKEY_NAME device property instead of DEVPKEY_Device_FriendlyName to display the name that identifies a device instance in a user interface display.

You can set the value of DEVPKEY_Device_FriendlyName by using an INF AddReg directive that is included in the INF DDInstall.HW section in the INF file that installs a device.

You can retrieve the value of DEVPKEY_Device_FriendlyName by calling SetupDiGetDeviceProperty or you can set this property by calling SetupDiSetDeviceProperty.

Windows Server 2003, Windows XP, and Windows 2000 support this property, but do not support the DEVPKEY_Device_FriendlyName property key. Instead, you can use the corresponding SPDRP_FRIENDLYNAME identifier to access the value of the property on these earlier versions of Windows. For information about how to access this property value on these earlier versions of Windows, see Accessing Device Instance SPDRP_Xxx Properties.

Requirements

Version: Windows Vista and later versions of Windows Header: Devpkey.h (include Devpkey.h)

See also

DEVPKEY_NAME (Device Instance)

INF AddReg Directive

INF DDInstall.HW Section

SetupDiGetDeviceProperty

SetupDiSetDeviceProperty