IMFMediaSession::Metode SetTopology (mfidl.h)
Mengatur topologi pada Sesi Media.
Sintaks
HRESULT SetTopology(
[in] DWORD dwSetTopologyFlags,
[in] IMFTopology *pTopology
);
Parameter
[in] dwSetTopologyFlags
Bitwise OR dari nol atau lebih bendera dari enumerasi MFSESSION_SETTOPOLOGY_FLAGS .
[in] pTopology
Arahkan ke antarmuka IMFTopology objek topologi .
Menampilkan nilai
Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil. |
|
Operasi tidak dapat dilakukan dalam status Sesi Media saat ini. |
|
Sesi Media telah dimatikan. |
|
Topologi memiliki nilai yang tidak valid untuk satu atau beberapa atribut berikut: |
|
Isi terproteksi tidak dapat diputar saat penelusuran kesalahan. |
Keterangan
Jika pTopology adalah topologi lengkap, atur bendera MFSESSION_SETTOPOLOGY_NORESOLUTION di parameter dwSetTopologyFlags . Jika tidak, topologi diasumsikan sebagai topologi parsial. Sesi Media menggunakan pemuat topologi untuk menyelesaikan topologi parsial menjadi topologi penuh.
Jika Sesi Media saat ini dijeda atau dihentikan, metode SetTopology tidak berlaku hingga panggilan berikutnya ke IMFMediaSession::Start.
Jika Sesi Media sedang berjalan, atau pada panggilan berikutnya ke Mulai, metode SetTopology melakukan hal berikut:
- Jika bendera MFSESSION_SETTOPOLOGY_IMMEDIATE diatur dalam dwSetTopologyFlags, Sesi Media segera mengakhiri presentasi saat ini, menghapus semua topologi yang tertunda, dan menggunakan pTopology untuk memulai presentasi baru.
- Jika tidak, Sesi Media mengantre pTopologi dan memulai presentasi baru ketika presentasi saat ini telah selesai. Jika tidak ada presentasi saat ini, presentasi baru akan segera dimulai.
- Mulai Windows 7, Anda juga dapat menentukan bendera MFSESSION_SETTOPOLOGY_CLEAR_CURRENT untuk menghapus topologi saat ini tetapi meninggalkan topologi lain yang tertunda pada antrean.
Persyaratan
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 |