IMFTopologyNode::ConnectOutput 方法 (mfidl.h)
將來自這個節點的輸出資料流程連接到另一個節點的輸入資料流程。
語法
HRESULT ConnectOutput(
[in] DWORD dwOutputIndex,
[in] IMFTopologyNode *pDownstreamNode,
[in] DWORD dwInputIndexOnDownstreamNode
);
參數
[in] dwOutputIndex
此節點上輸出資料流程以零起始的索引。
[in] pDownstreamNode
要連線之節點之 IMFTopologyNode 介面的指標。
[in] dwInputIndexOnDownstreamNode
另一個節點上輸入資料流程以零起始的索引。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
方法失敗。 |
|
無效的參數。 |
備註
節點連線代表從一個節點到下一個節點的資料流程。 資料流程是邏輯的,而且是由索引所指定。
如果節點已在指定的輸出連接,方法會中斷現有的連接。 如果 dwOutputIndex 或 dwInputIndexOnDownstreamNode 指定尚不存在的資料流程,此方法會視需要新增許多資料流程。
此方法會檢查特定不正確條件:
- 輸出節點不能有任何輸出連接。 如果您在輸出節點上呼叫此方法,此方法會傳回E_FAIL。
- 節點無法連線到本身。 如果 pDownstreamNode 指定與方法呼叫相同的節點,此方法會傳回E_INVALIDARG。
若要中斷現有的節點連線,請呼叫 IMFTopologyNode::D isconnectOutput。
需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | mfidl.h |
程式庫 | Mfuuid.lib |