DEVPKEY_DeviceInterface_FriendlyName

The DEVPKEY_DeviceInterface_FriendlyName device property represents the friendly name of a device interface.

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 SetupDiGetDeviceInterfaceProperty and set it by calling 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

Available in 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

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft