KSPROPERTY_SYSAUDIO_SELECT_GRAPH

KSPROPERTY_SYSAUDIO_SELECT_GRAPH 属性用于在 SysAudio 为虚拟音频设备上的 PIN 实例构建的图中显式包括可选节点。

使用情况摘要表

获取	设置	目标	属性描述符类型	属性值类型
否	是	筛选器	SYSAUDIO_SELECT_GRAPH	无

属性描述符（实例数据）是一种 SYSAUDIO_SELECT_GRAPH 类型的结构，用于指定属性、引脚 ID 和节点 ID。 该属性由类型为 KSPROPERTY 的嵌入结构指定。 引脚 ID 是标识 KS 筛选器中封装虚拟音频设备的引脚工厂的索引。 节点 ID 是标识指定引脚数据路径中的可选节点的索引。 有关更多信息，请参见下面的“备注”部分。

没有为此属性定义属性值（操作数据）。 将属性值的缓冲区指针指定为 NULL，并将其大小指定为零。

返回值

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

注解

此属性通常用于强制 AEC 节点进入引脚实例的图形中。

在为虚拟音频设备实例化筛选器上的渲染引脚时，SysAudio 从该引脚开始，默认情况下选择表示通过筛选器的最简单路径的图形。 此图不包括任何可选节点，例如 AEC 控件。

可以通过首先向 SysAudio 发送 KSPROPERTY_SYSAUDIO_SELECT_GRAPH set 属性请求来覆盖 SysAudio 的默认行为，该请求指定要包含在图形中的可选节点。 当 SysAudio 随后创建引脚实例时，引脚的图形将包括请求中指定的可选节点。

KSPROPERTY_SYSAUDIO_SELECT_GRAPH set 属性请求仅影响在请求后创建的引脚实例。 该请求对任何先前实例化的引脚都没有影响。

要求

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

另请参阅

SYSAUDIO_SELECT_GRAPH

KSPROPERTY