DEVPKEY_DeviceInterface_FriendlyName

Artikel
06/15/2023

Die DEVPKEY_DeviceInterface_FriendlyName Device-Eigenschaft stellt den Anzeigenamen einer Geräteschnittstelle dar.

attribute	Wert
Eigenschaftenschlüssel	DEVPKEY_DeviceInterface_FriendlyName
Eigenschaft-Datentypbezeichner	DEVPROP_TYPE_STRING
Eigenschaftenzugriff	Lese- und Schreibzugriff durch Installationsanwendungen und Installationsprogramme
Name des entsprechenden Registrierungswerts	Friendlyname
Lokalisierte?	Ja

Bemerkungen

Der FriendlyName-Registrierungswert für eine Geräteschnittstellenklasse wird von einer INF AddInterface-Anweisung festgelegt, die im INF DDInstall enthalten ist. Schnittstellenabschnitt der INF-Datei, die eine Geräteschnittstelle installiert.

Windows legt den Wert der DEVPKEY_NAME Geräteeigenschaft für eine Schnittstelle auf den Wert von DEVPKEY_DeviceInterface_FriendlyName fest. Um eine Geräteschnittstelle in einem Benutzeroberflächenelement zu identifizieren, verwenden Sie den Wert von DEVPKEY_NAME für die Geräteschnittstelle anstelle des Werts von DEVPKEY_DeviceInterface_FriendlyName.

Sie können den Wert des DEVPKEY_DeviceInterface_FriendlyName abrufen, indem Sie CM_Get_Device_Interface_Property oder SetupDiGetDeviceInterfaceProperty aufrufen und festlegen, indem Sie CM_Set_Device_Interface_Property oder SetupDiSetDeviceInterfaceProperty aufrufen.

Windows Server 2003, Windows XP und Windows 2000 unterstützen diese Eigenschaft, aber den DEVPKEY_DeviceInterface_FriendlyName-Eigenschaftsschlüssel nicht. Sie können auf den Wert dieser Eigenschaft zugreifen, indem Sie auf den entsprechenden Registrierungseintragswert von FriendlyName für die Geräteschnittstelle zugreifen. Informationen zum Zugreifen auf einen Registrierungseintragswert für eine Geräteschnittstelle finden Sie unter Zugreifen auf Geräteschnittstelleneigenschaften.

Informationen zu Geräteschnittstellen finden Sie unter Geräteschnittstellenklassen und in der INF AddInterface-Direktive.