共用方式為


IMFTopologyNode::ConnectOutput 方法 (mfidl.h)

將來自這個節點的輸出資料流程連接到另一個節點的輸入資料流程。

語法

HRESULT ConnectOutput(
  [in] DWORD           dwOutputIndex,
  [in] IMFTopologyNode *pDownstreamNode,
  [in] DWORD           dwInputIndexOnDownstreamNode
);

參數

[in] dwOutputIndex

此節點上輸出資料流程以零起始的索引。

[in] pDownstreamNode

要連線之節點之 IMFTopologyNode 介面的指標。

[in] dwInputIndexOnDownstreamNode

另一個節點上輸入資料流程以零起始的索引。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
此方法已成功。
E_FAIL
方法失敗。
E_INVALIDARG
無效的參數。

備註

節點連線代表從一個節點到下一個節點的資料流程。 資料流程是邏輯的,而且是由索引所指定。

如果節點已在指定的輸出連接,方法會中斷現有的連接。 如果 dwOutputIndexdwInputIndexOnDownstreamNode 指定尚不存在的資料流程,此方法會視需要新增許多資料流程。

此方法會檢查特定不正確條件:

  • 輸出節點不能有任何輸出連接。 如果您在輸出節點上呼叫此方法,此方法會傳回E_FAIL。
  • 節點無法連線到本身。 如果 pDownstreamNode 指定與方法呼叫相同的節點,此方法會傳回E_INVALIDARG。
不過,如果方法成功,則不保證節點連線有效。 可以建立拓撲載入器無法解析的部分拓撲。 如果是, IMFTopoLoader::Load 方法將會失敗。

若要中斷現有的節點連線,請呼叫 IMFTopologyNode::D isconnectOutput

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 mfidl.h
程式庫 Mfuuid.lib

另請參閱

IMFTopologyNode

拓撲