KSPROPERTY_AUDIO_FILTER_STATE

KSPROPERTY_AUDIO_FILTER_STATE 属性用于查询 GFX 筛选器，以获取它支持的属性集的列表。 该列表以属性集 GUID 数组的形式检索。

使用情况摘要表

获取	设置	目标	属性描述符类型	属性值类型
是	否	筛选器	KSPROPERTY	GUID 数组

属性数据（操作数据）是 GUID 数组。 数组中的每个 GUID 指定筛选器支持的属性集。

返回值

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

注解

此属性返回的 GUID 数组的大小取决于筛选器支持的属性集数。 在检索数组之前，客户端首先通过向微型端口驱动程序的属性处理程序发送具有零长度属性值缓冲区的 get-property 请求 KSPROPERTY_AUDIO_FILTER_STATE，来查询属性的 GUID 数组的大小。 处理程序通过返回所需的缓冲区大小和状态代码 STATUS_BUFFER_OVERFLOW 进行响应。 有关详细信息，请参阅音频属性处理程序。

通过 KSPROPERTY_AUDIO_FILTER_STATE get-property 请求中的 GUID 数组，操作系统可以串行询问每个属性集中的属性。 此信息使操作系统能够在实例化筛选器时还原 GFX 筛选器对象的状态，并在筛选器被销毁时保存 GFX 筛选器对象的状态。 保存或还原 GFX 筛选器的状态时，操作系统会按 KS 属性中所述，对每个属性集中的属性的请求进行序列化。 保存和还原 GFX 筛选器的状态的目的是保留用户对筛选器设置所做的任何更改，并使设置在筛选器的连续实例化中保持持久。 。

要求

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

另请参阅

KSPROPERTY