KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME

KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME 属性检索包含虚拟音频设备的友好名称的 Unicode 字符串。

使用情况摘要表

获取	设置	目标	属性描述符类型	属性值类型
是	否	筛选器	KSPROPERTY+ULONG	LPWSTR

属性描述符（实例数据）由 KSPROPERTY 结构组成，后跟一个 ULONG 变量，其中包含标识虚拟音频设备的设备 ID。 如果 SysAudio 枚举n 个虚拟音频设备（请参阅 KSPROPERTY_SYSAUDIO_DEVICE_COUNT），则有效的设备 ID 范围为 0 到 n-1。 此外，设备 ID 值为 -1 可用于指示当前设备，这是由 KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE 或 KSPROPERTY_SYSAUDIO_INSTANCE_INFOset 属性请求打开的最后一个虚拟音频设备。

属性值（操作数据）是指向包含设备友好名称的 Unicode 字符的以 null 结尾的字符串的指针。

返回值

KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME 属性请求返回 STATUS_SUCCESS，以指示已成功完成。 否则，请求将返回适当的错误状态代码。

要求

标头	Ksmedia.h（包括 Ksmedia.h）

另请参阅

KSPROPERTY

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

KSPROPERTY_SYSAUDIO_INSTANCE_INFO