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

另请参阅

KSP_PINMODE

KSPROPERTY_AUDIOSIGNALPROCESSING_MODES