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를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
MF_E_SHUTDOWN	미디어 세션이 종료되었습니다.

설명

dwGetFullTopologyFlags 매개 변수에 MFSESSION_GETFULLTOPOLOGY_CURRENT 플래그를 지정하면 메서드는 현재 프레젠테이션의 토폴로지를 반환합니다. 그렇지 않으면 메서드는 대기 중인 모든 토폴로지에서 TopoId 매개 변수에 지정된 식별자와 일치하는 토폴로지 중 하나를 검색합니다.

이 메서드를 사용하여 현재 프레젠테이션 또는 보류 중인 프레젠테이션의 토폴로지를 검색할 수 있습니다. 이미 종료된 토폴로지를 검색하는 데 사용할 수 없습니다.

ppFullTopo에서 반환된 토폴로지는 부분 토폴로지가 아닌 전체 토폴로지입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	mfidl.h
라이브러리	Mfuuid.lib

추가 정보

IMFMediaSession

TOPOID