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旗標。排序器會使用此資訊來結束管線的播放。否則，排序器會無限期等候新的拓撲排入佇列。