KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE

KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE 属性创建新的虚拟源。

使用情况摘要表

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

属性描述符（实例数据）是一种 SYSAUDIO_CREATE_VIRTUAL_SOURCE 类型的结构，用于指定虚拟源的引脚类别和引脚名称 GUID。

属性值（操作数据）是包含虚拟源索引的 ULONG 变量。 SysAudio 生成此索引，以标识新的虚拟源。

返回值

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

注解

此属性用于创建混音器线虚拟源，例如音量或静音控件。

如果 SysAudio 已经创建了具有相同引脚类别和引脚名称 GUID 的虚拟源，则 KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE get 属性请求将检索现有虚拟源的索引。 否则，请求将生成新的虚拟源索引并输出该值。

SysAudio 为虚拟源分配索引后，可以使用 KSPROPERTY_SYSAUDIO_ATTACH_VIRTUAL_SOURCEset 属性请求，将该虚拟源附加到虚拟音频设备上的引脚实例。

用户通过 SndVol32 应用程序控制各种音频源的音量级别。 这些源包括波形输出设备、MIDI 合成器、CD 播放器和线路输入插孔。 SndVol32 使用 Windows 多媒体 waveOutXxx、 midiOutXxx 和 auxXxx 函数来控制这些源的音量级别。 有关 Windows 多媒体函数的详细信息，请参阅 Microsoft Windows SDK 文档。

SysAudio 拦截对这些设备所做的音量更改，并将其应用于其虚拟源。 例如，如果将 MIDI 文件转换为波形数据的软件 MIDI 合成器连接到虚拟音频设备的波形渲染引脚之一，SysAudio 会将 midiOutXxx 音量更改应用到引脚（而不是 waveOutXxx 音量更改）。 同样，如果将 CD 播放器的数字音频转换为波形数据的 Redbook 系统驱动程序连接到虚拟音频设备的波形渲染引脚之一，SysAudio 会将 AUXCAPS_CDAUDIO 音量更改应用于该引脚。 有关 AUXCAPS_CDAUDIO 结构的详细信息，请参阅 Windows SDK 文档。

要求

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

另请参阅

SYSAUDIO_CREATE_VIRTUAL_SOURCE

KSPROPERTY_SYSAUDIO_ATTACH_VIRTUAL_SOURCE