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 |
---|---|
|
메서드가 성공했습니다. |
|
미디어 세션이 종료되었습니다. |
설명
dwGetFullTopologyFlags 매개 변수에 MFSESSION_GETFULLTOPOLOGY_CURRENT 플래그를 지정하면 메서드는 현재 프레젠테이션의 토폴로지를 반환합니다. 그렇지 않으면 메서드는 대기 중인 모든 토폴로지에서 TopoId 매개 변수에 지정된 식별자와 일치하는 토폴로지 중 하나를 검색합니다.
이 메서드를 사용하여 현재 프레젠테이션 또는 보류 중인 프레젠테이션의 토폴로지를 검색할 수 있습니다. 이미 종료된 토폴로지를 검색하는 데 사용할 수 없습니다.
ppFullTopo에서 반환된 토폴로지는 부분 토폴로지가 아닌 전체 토폴로지입니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | mfidl.h |
라이브러리 | Mfuuid.lib |