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

指定連接上游端節點的節點識別碼。 如果連線的這個結尾是篩選上的外部針腳，而不是節點上的邏輯接腳，請將此成員設定為 null 節點標識符值，KSFILTER_NODE。

FromNodePin

指定連接上游端的針腳標識碼。 如果 **FromNode ** 是KSFILTER_NODE，連接結尾的針腳是篩選上的外部接腳。 如果沒有，這個端的針腳是內部節點上的邏輯接點。

ToNode

指定連接下游端節點的節點識別碼。 如果連線的這個結尾是篩選上的外部針腳，而不是節點上的邏輯接腳，請將此成員設定為 null 節點標識符值，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的別名。 PCCONNECTION_DESCRIPTOR iMiniport：：GetDescription () 是迷你埠所實作篩選拓撲中的節點連線描述。 其定義方式如下：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

KSPROPERTY_TOPOLOGY_CONNECTIONS

KSPROPSETID_Pin

KSPROPSETID_Topology