IMFSequencerSource：：AppendTopology 方法 (mfidl.h)

将拓扑添加到队列的末尾。

语法

HRESULT AppendTopology(
  [in]  IMFTopology          *pTopology,
  [in]  DWORD                dwFlags,
  [out] MFSequencerElementId *pdwId
);

[in] pTopology

指向拓扑的 IMFTopology 接口的指针。此指针不能为 NULL。如果应用程序通过 NULL，调用将失败并出现E_INVALIDARG错误代码。

[in] dwFlags

[out] pdwId

接收此拓扑的 sequencer 元素标识符。

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

返回代码	说明
S_OK	方法成功。
MF_E_ATTRIBUTENOTFOUND	源拓扑节点缺少以下属性之一： MF_TOPONODE_STREAM_DESCRIPTOR MF_TOPONODE_PRESENTATION_DESCRIPTOR MF_TOPONODE_SOURCE

排序器按排队顺序播放拓扑。可以根据需要对任意数量的拓扑进行排队以预滚动。

应用程序必须在将媒体会话上的最后一个拓扑排队时向排序程序指示。若要指定最后一个拓扑，请在追加拓扑时在 dwFlags 参数中设置SequencerTopologyFlags_Last标志。排序器使用此信息通过管道结束播放。否则，Sequencer 将无限期地等待新拓扑排队。