KSTOPOLOGY 结构 (ks.h)

  • 项目

KSTOPOLOGY 结构描述了引脚和节点的拓扑。

语法

typedef struct {
  ULONG                       CategoriesCount;
  const GUID                  *Categories;
  ULONG                       TopologyNodesCount;
  const GUID                  *TopologyNodes;
  ULONG                       TopologyConnectionsCount;
  const KSTOPOLOGY_CONNECTION *TopologyConnections;
  const GUID                  *TopologyNodesNames;
  ULONG                       Reserved;
} KSTOPOLOGY, *PKSTOPOLOGY;

成员

CategoriesCount

指定驱动程序支持的功能类别数。

Categories

指向驱动程序支持的功能类别数组的开头。

TopologyNodesCount

指定驱动程序支持的节点数。

TopologyNodes

指向描述每个节点类型的 GUID 数组的开头。 有关视频内核流式处理相关节点的列表，请参阅 内核流式处理拓扑节点。 有关音频内核流式处理相关节点的列表，请参阅 音频拓扑节点。

TopologyConnectionsCount

指定 TopologyConnections 指向的数组中的条目数。 每个条目的节点编号必须对应于 TopologyNodes 中节点的数组偏移量。 当此结构是流式处理微型驱动程序HW_STREAM_HEADER的一部分时，引脚编号必须与微型驱动程序HW_STREAM_DESCRIPTOR结构中HW_STREAM_INFORMATION结构数组中的偏移量相对应。

TopologyConnections

指向此结构的拓扑连接数组的开头。

TopologyNodesNames

指定存储在注册表中的节点的本地化 Unicode 字符串名称的 GUID。

Reserved

预留给系统使用。 驱动程序应将此设置为零。

注解

流类微型驱动程序创建并传递此结构作为其 HW_STREAM_HEADER 结构的一部分。 类驱动程序使用此结构来处理拓扑属性请求。 类驱动程序返回的属性数据根据 KSTOPOLOGY 结构确定，如下所示：

要求

要求 值
Header ks.h (包括 Ks.h)

另请参阅

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER

HW_STREAM_INFORMATION

KSTOPOLOGY_CONNECTION