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 结构确定，如下所示：
要求
| 要求 | 价值 |
|---|---|
| 标头 | ks.h （包括 Ks.h） |