IMFTopologyNode::ConnectOutput メソッド (mfidl.h)

このノードからの出力ストリームを別のノードの入力ストリームに接続します。

構文

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

パラメーター

[in] dwOutputIndex

このノードの出力ストリームの 0 から始まるインデックス。

[in] pDownstreamNode

接続するノードの IMFTopologyNode インターフェイスへのポインター。

[in] dwInputIndexOnDownstreamNode

もう一方のノードの入力ストリームの 0 から始まるインデックス。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	メソッドが成功しました。
E_FAIL	メソッドが失敗しました。
E_INVALIDARG	無効なパラメーター。

解説

ノード接続は、あるノードから次のノードへのデータ フローを表します。 ストリームは論理的であり、index で指定されます。

指定した出力でノードが既に接続されている場合、 メソッドは既存の接続を切断します。 dwOutputIndex または dwInputIndexOnDownstreamNode で、まだ存在しないストリームが指定されている場合、メソッドは必要な数のストリームを追加します。

このメソッドは、特定の無効な条件をチェックします。

• 出力ノードに出力接続を設定することはできません。 出力ノードでこのメソッドを呼び出すと、メソッドは E_FAILを返します。
• ノードをそれ自体に接続することはできません。 pDownstreamNode でメソッド呼び出しと同じノードが指定されている場合、メソッドは E_INVALIDARGを返します。

ただし、メソッドが成功した場合、ノード接続が有効であることは保証されません。 トポロジ ローダーで解決できない部分トポロジを作成できます。 その場合、 IMFTopoLoader::Load メソッドは失敗します。

既存のノード接続を切断するには、 IMFTopologyNode::D isconnectOutput を呼び出します。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	mfidl.h
Library	Mfuuid.lib

関連項目

IMFTopologyNode

トポロジ