IMFMediaSession::GetFullTopology メソッド (mfidl.h)

メディア セッションからトポロジを取得します。

このメソッドは、現在のトポロジまたはキューに登録されたトポロジを取得できます。

構文

HRESULT GetFullTopology(
  [in]  DWORD       dwGetFullTopologyFlags,
  [in]  TOPOID      TopoId,
  [out] IMFTopology **ppFullTopology
);

パラメーター

[in] dwGetFullTopologyFlags

MFSESSION_GETFULLTOPOLOGY_FLAGS列挙体からの 0 個以上のフラグのビットごとの OR。

[in] TopoId

トポロジの識別子。 dwGetFullTopologyFlags パラメーターに MFSESSION_GETFULLTOPOLOGY_CURRENT フラグが含まれている場合、このパラメーターは無視されます。 トポロジの識別子を取得するには、 IMFTopology::GetTopologyID を呼び出します。

[out] ppFullTopology

トポロジの IMFTopology インターフェイスへのポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。

戻り値

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

リターン コード	説明
S_OK	メソッドが成功しました。
MF_E_SHUTDOWN	メディア セッションがシャットダウンされました。

注釈

dwGetFullTopologyFlags パラメーターに MFSESSION_GETFULLTOPOLOGY_CURRENT フラグが指定されている場合、メソッドは現在のプレゼンテーションのトポロジを返します。 それ以外の場合、メソッドは、キューに登録されているすべてのトポロジで 、TopoId パラメーターで指定された識別子と一致するものを検索します。

このメソッドを使用して、現在のプレゼンテーションまたは保留中のプレゼンテーションのトポロジを取得できます。 既に終了しているトポロジを取得するために使用することはできません。

ppFullTopo で返されるトポロジは完全なトポロジであり、部分トポロジではありません。

要件

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

こちらもご覧ください

IMFMediaSession

TOPOID