IMFMediaSession：：GetFullTopology 方法 (mfidl.h)

从媒体会话获取拓扑。

此方法可以获取当前拓扑或排队拓扑。

语法

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

[in] dwGetFullTopologyFlags

MFSESSION_GETFULLTOPOLOGY_FLAGS枚举中的零个或多个标志的按位 OR。

[in] TopoId

拓扑的标识符。如果 dwGetFullTopologyFlags 参数包含 MFSESSION_GETFULLTOPOLOGY_CURRENT 标志，则忽略此参数。若要获取拓扑的标识符，请调用 IMFTopology：：GetTopologyID。

[out] ppFullTopology

接收指向拓扑的 IMFTopology 接口的指针。调用方必须释放接口。

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

返回代码	说明
S_OK	方法成功。
MF_E_SHUTDOWN	媒体会话已关闭。

如果在 dwGetFullTopologyFlags 参数中指定了 MFSESSION_GETFULLTOPOLOGY_CURRENT 标志，则该方法将返回当前演示文稿的拓扑。否则，方法会搜索所有排队的拓扑，以查找与 TopoId 参数中给定的标识符匹配的拓扑。

此方法可用于检索当前演示文稿或任何挂起演示文稿的拓扑。它不能用于检索已结束的拓扑。

ppFullTopo 中返回的拓扑是完整拓扑，而不是部分拓扑。