DEVPKEY_DeviceInterface_FriendlyName
The DEVPKEY_DeviceInterface_FriendlyName device property represents the friendly name of a device interface.
| Attribute | Value |
|---|---|
Property key |
DEVPKEY_DeviceInterface_FriendlyName |
Property-data-type identifier |
|
Property access |
Read and write access by installation applications and installers |
Corresponding registry value name |
FriendlyName |
Localized? |
Yes |
Remarks
The FriendlyName registry value for a device interface class is set by an INF AddInterface directive that is included in the INF DDInstall.Interface section of the INF file that installs a device interface.
Windows sets the value of the DEVPKEY_NAME device property for an interface to the value of DEVPKEY_DeviceInterface_FriendlyName. To identify a device interface in a user interface item, use the value of DEVPKEY_NAME for the device interface instead of the value of DEVPKEY_DeviceInterface_FriendlyName.
You can retrieve the value of the DEVPKEY_DeviceInterface_FriendlyName by calling CM_Get_Device_Interface_Property or SetupDiGetDeviceInterfaceProperty and set it by calling CM_Set_Device_Interface_Property or SetupDiSetDeviceInterfaceProperty.
Windows Server 2003, Windows XP, and Windows 2000 support this property, but do not support the DEVPKEY_DeviceInterface_FriendlyName property key. You can access the value of this property by accessing the corresponding FriendlyName registry entry value for the device interface. For information about how to access a registry entry value for a device interface, see Accessing Device Interface Properties.
For information about device interfaces, see Device Interface Classes and the INF AddInterface Directive.
Requirements
Version: Windows Vista and later versions of Windows Header: Devpkey.h (include Devpkey.h)
See also
DEVPKEY_NAME (Device Interface)
INF DDInstall.Interface Section
SetupDiGetDeviceInterfaceProperty