IMFTopoLoader::Muat metode (mfidl.h)

  • Artikel

Membuat topologi yang dimuat sepenuhnya dari topologi parsial input.

Sintaks

HRESULT Load(
  [in]  IMFTopology *pInputTopo,
  [out] IMFTopology **ppOutputTopo,
  [in]  IMFTopology *pCurrentTopo
);

Parameter

[in] pInputTopo

Penunjuk ke antarmuka IMFTopology dari topologi parsial yang akan diselesaikan.

[out] ppOutputTopo

Menerima pointer ke antarmuka IMFTopology dari topologi yang telah selesai. Pemanggil harus merilis antarmuka.

[in] pCurrentTopo

Penunjuk ke antarmuka IMFTopology dari topologi lengkap sebelumnya. Pemuat topologi dapat menggunakan kembali objek dari topologi ini dalam topologi baru. Parameter ini bisa NULL. Lihat Keterangan.

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_TOPO_SINK_ACTIVATES_UNSUPPORTED
 Satu atau beberapa simpul output berisi penunjuk IMFActivate . Pemanggil harus mengikat simpul output ke sink media. Lihat Mengikat Simpul Output ke Sink Media.

Keterangan

Metode ini menciptakan transformasi perantara yang diperlukan untuk menyelesaikan topologi. Ini juga mengatur jenis media input dan output pada semua objek dalam topologi. Jika metode berhasil, topologi lengkap dikembalikan dalam parameter ppOutputTopo .

Anda dapat menggunakan parameter pCurrentTopo untuk memberikan topologi lengkap yang sebelumnya dimuat. Jika topologi ini berisi objek yang diperlukan dalam topologi baru, pemuat topologi dapat menggunakannya kembali tanpa membuatnya lagi. Penembolokan ini berpotensi membuat proses lebih cepat. Objek dari pCurrentTopo tidak akan dikonfigurasi ulang, sehingga Anda dapat menentukan topologi yang secara aktif mengalirkan data. Misalnya, saat topologi masih berjalan, Anda dapat memuat topologi berikutnya terlebih dahulu.

Sebelum memanggil metode ini, Anda harus memastikan bahwa simpul output dalam topologi parsial memiliki pointer IMFStreamSink yang valid, bukan pointer IMFActivate . Sesi Media secara otomatis melakukan tindakan ini di dalam metode IMFMediaSession::SetTopology . Namun, jika Anda memanggil Muat sebelum memanggil SetTopology, Anda harus mengikat simpul output secara manual. Untuk informasi selengkapnya, lihat Mengikat Simpul Output ke Sink Media.

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

Lihat juga

Bangunan Topologi Tingkat Lanjut

IMFTopoLoader

Topologi