Antarmuka IGraphConfig (strmif.h)

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Filter Graph Manager mengekspos IGraphConfig untuk mendukung bangunan grafik dinamis. Antarmuka ini memungkinkan aplikasi dan filter untuk mengonfigurasi ulang grafik filter saat grafik dalam keadaan berjalan, dan tanpa kehilangan data dari aliran.

Cara paling mudah untuk membangun kembali grafik secara dinamis adalah dengan memanggil metode IGraphConfig::Reconnect . Metode ini menangani sebagian besar detail pembangunan ulang grafik secara dinamis. Jika situasi muncul di mana Anda ingin menerapkan teknik Anda sendiri, IGraphConfig juga menyediakan metode IGraphConfig::Reconfigure . Metode ini mendapatkan kunci pada grafik filter dan kemudian memanggil fungsi panggilan balik di aplikasi Anda, yang mengonfigurasi ulang grafik. Dengan metode ini, sebagian besar pekerjaan digeser ke aplikasi Anda. Untuk informasi selengkapnya, lihat Dynamic Graph Building.

Untuk mengoptimalkan proses penambahan dan penghapusan filter, grafik filter mempertahankan cache filter. Selama panggilan ke metode Sambungkan Ulang , Anda dapat menentukan bahwa filter apa pun yang dihapus dari grafik ditambahkan ke cache. Anda juga dapat menambahkan filter ke cache secara langsung, jika Anda tahu itu mungkin diperlukan, dengan memanggil IGraphConfig::AddFilterToCache. Metode IGraphBuilder::Render, IGraphBuilder::RenderFile, dan IGraphBuilder::Connect secara otomatis mencoba menggunakan filter di cache sebelum menggunakan filter lain. Selain itu, dalam metode Sambungkan Ulang Anda dapat menentukan bahwa hanya filter yang di-cache yang akan digunakan untuk koneksi ulang. Perhatikan bahwa filter yang disimpan di cache sebenarnya bukan bagian dari grafik. Mereka terputus dari pin apa pun dan disimpan dalam status berhenti.

Warisan

Antarmuka IGraphConfig mewarisi dari antarmuka IUnknown . IGraphConfig juga memiliki jenis anggota ini:

Metode

Antarmuka IGraphConfig memiliki metode ini.

IGraphConfig::AddFilterToCache Metode AddFilterToCache menambahkan filter ke cache filter.
IGraphConfig::EnumCacheFilter Metode EnumCacheFilter menghitung filter dalam cache filter.
IGraphConfig::GetFilterFlags Metode GetFilterFlags mengambil informasi konfigurasi filter.
IGraphConfig::GetStartTime Metode GetStartTime mengambil waktu referensi yang digunakan saat grafik filter terakhir dimasukkan ke dalam status berjalan.
IGraphConfig::P ushThroughData Metode PushThroughData mendorong data melalui grafik filter ke pin yang ditentukan.
IGraphConfig::Konfigurasi ulang Metode Konfigurasi Ulang mengunci grafik filter dan memanggil fungsi panggilan balik dalam aplikasi atau filter untuk melakukan konfigurasi ulang dinamis.
IGraphConfig::Sambungkan kembali Metode Sambungkan Ulang melakukan koneksi ulang dinamis di antara dua pin.
IGraphConfig::RemoveFilterEx Metode RemoveFilterEx menghapus filter dari grafik filter.
IGraphConfig::RemoveFilterFromCache Metode RemoveFilterFromCache menghapus filter dari cache filter.
IGraphConfig::SetFilterFlags Metode SetFilterFlags menetapkan informasi konfigurasi filter.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)