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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。
リターン コード | 説明 |
---|---|
|
メソッドが成功しました。 |
|
ソース トポロジ ノードに、次のいずれかの属性がありません。 |
解説
シーケンサーは、キューに登録されている順序でトポロジを再生します。 事前登録するトポロジはいくつでもキューに登録できます。
アプリケーションは、メディア セッションで最後のトポロジをキューに入れたときに、シーケンサーに指示する必要があります。 最後のトポロジを指定するには、トポロジを追加するときに dwFlags パラメーターに SequencerTopologyFlags_Last フラグを設定します。 シーケンサーはこの情報を使用して、パイプラインでの再生を終了します。 それ以外の場合、シーケンサーは新しいトポロジがキューに登録されるまで無期限に待機します。
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | mfidl.h |
Library | Mfuuid.lib |