Share via

IMFTopologyNode：：ConnectOutput 方法 (mfidl.h)

  • 项目

将输出流从此节点连接到另一个节点的输入流。

语法

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

parameters

[in] dwOutputIndex

此节点上输出流的从零开始的索引。

[in] pDownstreamNode

指向要连接到的节点的 IMFTopologyNode 接口的指针。

[in] dwInputIndexOnDownstreamNode

另一个节点上输入流的从零开始的索引。

返回值

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码 说明
S_OK
 方法成功。
E_FAIL
 方法失败。
E_INVALIDARG
 参数无效。

注解

节点连接表示从一个节点到另一个节点的数据流。 流是逻辑的，由索引指定。

如果节点已在指定的输出处连接，则 方法会中断现有连接。 如果 dwOutputIndex 或 dwInputIndexOnDownstreamNode 指定尚不存在的流，则 方法会根据需要添加任意数量的流。

此方法检查某些无效条件：

  • 输出节点不能有任何输出连接。 如果在输出节点上调用此方法，该方法将返回E_FAIL。
  • 节点无法连接到自身。 如果 pDownstreamNode 指定与方法调用相同的节点，该方法将返回E_INVALIDARG。
但是，如果方法成功，则不保证节点连接有效。 可以创建拓扑加载程序无法解析的部分拓扑。 如果是这样， IMFTopoLoader：：Load 方法将失败。

若要中断现有节点连接，请调用 IMFTopologyNode：:D isconnectOutput。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 mfidl.h
Library Mfuuid.lib

另请参阅

IMFTopologyNode

拓扑