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
保留供系統使用。 驅動程式應該將此設定為零。
備註
數據流類別 minidriver 會建立並傳遞此結構作為其 HW_STREAM_HEADER 結構的一部分。 類別驅動程式會使用此結構來處理拓撲屬性要求。 類別驅動程式傳回的屬性數據取決於 KSTOPOLOGY 結構，如下所示：
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | ks.h (包含 Ks.h) |