PCNODE_DESCRIPTOR结构 (portcls.h)

项目
02/26/2024

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 ，以指示应使用 Type 成员中的 GUID 来确定节点名称。

注解

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

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