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 中傳回的拓撲是完整的拓撲，而不是部分拓撲。