KSPROPERTY_AUDIO_ALGORITHM_INSTANCE
KSPROPERTY_AUDIO_ALGORITHM_INSTANCE 属性指定用于实现节点应用于音频数据流的第三方效果的数字信号处理 (DSP) 算法。 为此属性定义的效果包括声学回声消除和噪音抑制。
使用情况摘要表
获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
---|---|---|---|---|
是 |
是 |
筛选器 |
GUID |
属性值(操作数据)是一个 GUID,用于标识引脚应用于其数据流的效果。 此值可以是头文件 Ksmedia.h 中的以下 GUID 之一:
KSALGORITHMINSTANCE_SYSTEM_AGC
预留供以后使用
KSALGORITHMINSTANCE_SYSTEM_ACOUSTIC_ECHO_CANCEL
系统默认声学回声取消算法
KSALGORITHMINSTANCE_SYSTEM_MICROPHONE_ARRAY_PROCESSOR
预留供以后使用
KSALGORITHMINSTANCE_SYSTEM_NOISE_SUPPRESS
系统默认噪音抑制算法
返回值
KSPROPERTY_AUDIO_ALGORITHM_INSTANCE 属性请求返回 STATUS_SUCCESS,以指示它已成功完成。 否则,请求将返回适当的错误状态代码。
注解
此属性用于控制 AEC 节点 (KSNODETYPE_ACOUSTIC_ECHO_CANCEL) 或噪音抑制节点 (KSNODETYPE_NOISE_SUPPRESS) 执行的 DSP 算法。
算法实例 GUID 与调用方传递给 IDirectSoundCapture::CreateCaptureBuffer 方法或 DirectSoundFullDuplexCreate 函数的 DSCEFFECTDESC 结构的 guidDSCFXInstance 成员中的值匹配。 有关详细信息,请参阅 Microsoft Windows SDK 文档。
要求
标头 |
Ksmedia.h(包括 Ksmedia.h) |