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 結構決定，如下所示：

要求

另請參閱

HW_STREAM_DESCRIPTOR

HW_STREAM_HEADER

HW_STREAM_INFORMATION

KSTOPOLOGY_CONNECTION