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) |