IMFSequencerSource::AppendTopology メソッド (mfidl.h)

  • [アーティクル]

トポロジをキューの末尾に追加します。

構文

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

パラメーター

[in] pTopology

トポロジの IMFTopology インターフェイスへのポインター。 このポインターを NULL にすることはできません。 アプリケーションが NULL を渡すと、呼び出しはE_INVALIDARGエラー コードで失敗します。

[in] dwFlags

MFSequencerTopologyFlags 列挙からのフラグの組み合わせ。

[out] pdwId

このトポロジのシーケンサー要素識別子を受け取ります。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
MF_E_ATTRIBUTENOTFOUND
 ソース トポロジ ノードに、次のいずれかの属性がありません。

解説

シーケンサーは、キューに登録されている順序でトポロジを再生します。 事前登録するトポロジはいくつでもキューに登録できます。

アプリケーションは、メディア セッションで最後のトポロジをキューに入れたときに、シーケンサーに指示する必要があります。 最後のトポロジを指定するには、トポロジを追加するときに dwFlags パラメーターに SequencerTopologyFlags_Last フラグを設定します。 シーケンサーはこの情報を使用して、パイプラインでの再生を終了します。 それ以外の場合、シーケンサーは新しいトポロジがキューに登録されるまで無期限に待機します。

要件

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

関連項目

Sequencer ソースについて

IMFSequencerSource

MFCreateTopologyNode