KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST
KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST 属性是一个筛选器属性，其值为应用于特定 KS 引脚工厂的音频效果类型列表，用于特定音频信号处理路径。
使用情况摘要表
使用情况摘要表
| 获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
是 |
否 |
引脚工厂（通过筛选器实例） |
KSP_PIN |
KSP_PINMODE |
属性值是一个由零个或多个音频效果类型 GUID（例如，AUDIO_EFFECT_TYPE_ACOUSTIC_ECHO_CANCELLATION）构成的数组，该数组位于由 KSP_PINMODE 结构标识的引脚信号处理路径中。
注意 不能为此属性设置 KSPROPERTY_TYPE_TOPOLOGY 标志位。
返回值
KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST 属性请求返回 STATUS_SUCCESS，以指示它已成功完成。 否则，此属性请求将返回适当的错误状态代码。
注解
如果音频驱动程序使用 Microsoft 的通用代理 APO 检索 KS 引脚的不同信号处理路径中包含的音频效果，则必须支持此属性。 通用代理 APO 包含在 msapofxproxy.dll 文件中。 音频驱动程序可以在音频驱动程序或相应的数字信号处理器 (DSP) 硬件组件中完成所有信号处理时使用此通用代理 APO，且 APO 中未完成任何处理。 在这种情况下，APO 的唯一功能是向音频系统报告信号处理效果。
通用代理 APO 从音频驱动程序接收 KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST，并使用它向音频系统报告效果。 通用代理 APO 假定启用 KS 引脚的筛选器接口时效果列表不会更改。
如果属性描述符指定不支持 KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST 的 KS 引脚，则驱动程序必须返回 STATUS_NOT_SUPPORTED。
如果属性描述符指定驱动程序不支持的 AudioProcessingMode 值，则驱动程序必须返回 STATUS_INVALID_PARAMETER。 请注意，音频驱动程序必须支持 KSPROPERTY_AUDIOSIGNALPROCESSING_MODES 属性，才能指示其支持的音频信号处理模式。
要求
版本 |
Windows 8.1 |
标头 |
Msapofxproxy.h |