PCNODE_DESCRIPTOR结构（portcls.h）

PCNODE_DESCRIPTOR 结构描述拓扑微型端口驱动程序实现的筛选器中的节点。

语法

typedef struct {
  ULONG                    Flags;
  const PCAUTOMATION_TABLE *AutomationTable;
  const GUID               *Type;
  const GUID               *Name;
} PCNODE_DESCRIPTOR, *PPCNODE_DESCRIPTOR;

成员

Flags

设置为零。 当前未定义任何标志位。

AutomationTable

指向自动化表的指针，它是 PCAUTOMATION_TABLE类型的结构。 此成员可以设置为 NULL，以指示没有自动化支持。 自动化表指定属于节点实例的属性和事件的处理程序。

Type

指定节点类型。 此成员是指向唯一标识节点类型的 GUID 的指针。 请参阅 音频拓扑节点中的节点类型 GUID 列表。

Name

指向表示此拓扑节点名称的 GUID 的指针。 此 GUID 是在获取节点的相应名称字符串的 KSPROPERTY_TOPOLOGY_NAMEget-property 请求中指定的。 此指针可以设置为 NULL，以指示 类型 成员中的 GUID 应用于确定节点名称。

言论

如果筛选器仅包含由 类型 成员指定的类型的单个节点，则可以将 名称 成员指定为 NULL，因为 类型 值足以唯一标识筛选器中的节点。 如果筛选器包含两个或更多个相同类型的节点，则这些节点的 名称 成员必须是非NULL。

例如，如果筛选器包含单个 SUM 节点，则该节点的 类型 成员指向 GUID 值 KSNODETYPE_SUM，并且 名称 成员设置为 NULL。 当查询该节点的名称时，KSPROPERTY_TOPOLOGY_NAME 属性在确定节点的 名称 值 NULL后，从KSNODETYPE_SUM GUID 的注册表项中检索名称字符串。 但是，同一筛选器可能包含多个卷节点，在这种情况下，这些节点的 类型 值都指向相同的 GUID 值，KSNODETYPE_VOLUME，名称 值必须唯一标识每个卷节点。 例如，波形输入音量控制节点 名称 值应指向 GUID 值KSAUDFNAME_WAVE_IN_VOLUME（在 ksmedia.h 中定义）。 此 GUID 的注册表项包含KSPROPERTY_TOPOLOGY_NAME属性为节点检索的名称字符串。

PCFILTER_DESCRIPTOR 结构包含指向 PCNODE_DESCRIPTOR 结构的数组的指针。

有关演示如何使用 PCNODE_DESCRIPTOR 结构的简单代码示例，请参阅 公开筛选器拓扑。

要求

另请参阅

KSPROPERTY_TOPOLOGY_NAME

PCAUTOMATION_TABLE

PCFILTER_DESCRIPTOR