KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE
KSPROPERTY_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） |