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 |
|
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)