Edit

DEVPKEY_DeviceInterface_FriendlyName

  • Article

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

DEVPROP_TYPE_STRING

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 AddInterface Directive

INF DDInstall.Interface Section

SetupDiGetDeviceInterfaceProperty

SetupDiOpenDeviceInterfaceRegKey

SetupDiSetDeviceInterfaceProperty