IMFMediaSession::Metode GetFullTopology (mfidl.h)

Mendapatkan topologi dari Sesi Media.

Metode ini bisa mendapatkan topologi saat ini atau topologi antrean.

Sintaks

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

Parameter

[in] dwGetFullTopologyFlags

Bitwise OR dari nol atau lebih bendera dari enumerasi MFSESSION_GETFULLTOPOLOGY_FLAGS .

[in] TopoId

Pengidentifikasi topologi. Parameter ini diabaikan jika parameter dwGetFullTopologyFlags berisi bendera MFSESSION_GETFULLTOPOLOGY_CURRENT . Untuk mendapatkan pengidentifikasi topologi, panggil IMFTopology::GetTopologyID.

[out] ppFullTopology

Menerima pointer ke antarmuka IMFTopology dari topologi. Pemanggil harus merilis antarmuka.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
MF_E_SHUTDOWN	Sesi Media telah dimatikan.

Keterangan

Jika bendera MFSESSION_GETFULLTOPOLOGY_CURRENT ditentukan dalam parameter dwGetFullTopologyFlags , metode mengembalikan topologi untuk presentasi saat ini. Jika tidak, metode mencari semua topologi yang diantrekan untuk yang cocok dengan pengidentifikasi yang diberikan dalam parameter TopoId .

Metode ini dapat digunakan untuk mengambil topologi untuk presentasi saat ini atau presentasi yang tertunda. Ini tidak dapat digunakan untuk mengambil topologi yang telah berakhir.

Topologi yang dikembalikan dalam ppFullTopo adalah topologi lengkap, bukan topologi parsial.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfidl.h
Pustaka	Mfuuid.lib

Lihat juga

IMFMediaSession

TOPOID