KSTOPOLOGY_CONNECTION結構 （ks.h）
KSTOPOLOGY_CONNECTION 結構描述核心串流篩選內的單一數據路徑連線。
PCCONNECTION_DESCRIPTOR是KSTOPOLOGY_CONNECTION的別名。
語法
typedef struct {
ULONG FromNode;
ULONG FromNodePin;
ULONG ToNode;
ULONG ToNodePin;
} KSTOPOLOGY_CONNECTION, *PKSTOPOLOGY_CONNECTION;
成員
FromNode
指定連接上游端節點的節點識別碼。 如果連線的這個結尾是篩選上的外部針腳，而不是節點上的邏輯針腳，m 會將這個成員設定為 null node-ID 值，KSFILTER_NODE。
FromNodePin
指定連接上游端的針腳標識碼。 如果 **FromNode **是KSFILTER_NODE，則連接端的針腳是篩選上的外部針腳。 如果沒有，此端的針腳是內部節點上的邏輯針腳。
ToNode
指定連接下游端節點的節點識別碼。 如果連線的這個結尾是篩選上的外部針腳，而不是節點上的邏輯釘選，請將這個成員設定為 null node-ID 值，KSFILTER_NODE。
ToNodePin
指定連接下游端的針腳標識碼。 如果 ToNode 是KSFILTER_NODE，則連接端的針腳是篩選上的外部針腳。 如果沒有，此端的針腳是內部節點上的邏輯針腳。
言論
KSTOPOLOGY_CONNECTION代表篩選內的單一連線，介於外部針腳、內部節點或外部針腳和內部節點之間。
串流驅動程式會傳回KSTOPOLOGY_CONNECTION結構的陣列，以回應 KSPROPERTY_TOPOLOGY_CONNECTIONS get-property 要求。
當代表兩個外部針腳之間的連線時，FromNode 和 ToNode 都應該設定為 KSFILTER_NODE，而 FromNodePin 和 ToNodePin 應該是個別針腳的針腳類型識別符。 如需針腳類型標識碼的描述，請參閱 KSPROPSETID_Pin。
否則，FromNodePin 或 ToNodePin 代表連線的邏輯連入或傳出釘選。 邏輯針腳數位僅用於描述節點之間的連線;它們不存在於KSPROPERTY_TOPOLOGY_CONNECTIONS屬性之外。
PCCONNECTION_DESCRIPTOR
PCCONNECTION_DESCRIPTOR結構名稱是KSTOPOLOGY_CONNECTION的別名。 iMiniport：：GetDescription（） 的 PCCONNECTION_DESCRIPTOR是迷你埠所實作之篩選拓撲中的節點連線描述。 它會在 portcls.h 標頭中定義如下：
typedef KSTOPOLOGY_CONNECTION PCCONNECTION_DESCRIPTOR, *PPCCONNECTION_DESCRIPTOR;
請注意，針對參數描述，PCFILTER_NODE 會與 PCCONNECTION_DESCRIPTOR 搭配使用，而不是KSFILTER_NODE。
PCCONNECTION_DESCRIPTOR 結構會指定篩選條件內的單一連線。 線上可以是下列其中一項：
兩個內部節點之間的連線
內部節點與篩選上針腳之間的連線
篩選上兩個針腳之間的連線
當篩選條件上的輸入針腳直接串流至相同篩選上的輸出釘選時，就會發生最後一種連線類型。
配接器驅動程式會使用結構的數位來指定篩選的內部拓撲。
數據流會從 FromNode 端流至連線 ToNode 端。
若要使用 PCCONNECTION_DESCRIPTOR 結構，驅動程式寫入器會將「邏輯」釘選指派給篩選內的節點。 這些「針腳」是節點上的連接點，類似於篩選條件用來連線到其他篩選的外部針腳。 不過，節點上的邏輯針腳只能用來指定篩選條件內的連線。
具有單一輸入和單一輸出的簡單節點，通常會分別編號其輸入和輸出釘選一個和零。 根據慣例，此編號是根據 IRP 流程的方向而非數據流。
更複雜的節點可能需要標準化的針腳標識碼，以便讓用戶端更輕鬆地判斷將函式指派給特定針腳。 例如，KSNODETYPE_ACOUSTIC_ECHO_CANCEL 節點會針對其四個針腳使用標準化標識符。
當連接一端的針腳是篩選上的輸入或輸出釘選，而不是節點上的邏輯釘選時，請將 FromNode 或 ToNode 成員（視您要指定的連接結束而定），設定為 null 節點標識符值，PCFILTER_NODE。
請避免混淆邏輯針腳，這隻用來描述篩選內節點上的連接點，以及篩選用來連線到其他篩選的外部針腳。 邏輯針腳很少在 PCCONNECTION_DESCRIPTOR 結構之外使用。 在本檔中，釘選 一詞是指 KS 篩選器上的針腳，除非另有說明，否則是指節點上的釘選。
IMiniport：：GetDescription 方法會輸出包含 PCCONNECTION_DESCRIPTOR 陣列指標的 PCFILTER_DESCRIPTOR 結構。
如需示範如何使用 PCCONNECTION_DESCRIPTOR 結構的簡單程式代碼範例，請參閱 公開篩選拓撲。
要求
| 要求 | 價值 |
|---|---|
| 標頭 | ks.h （包括 Ks.h） |
另請參閱
BdaPropertyTemplateConnections