Bagikan melalui


Filter Manajer Grafik

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan 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 Audio/Video Capture 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 menyusun dan mengontrol grafik filter. Objek ini adalah komponen pusat di DirectShow. Aplikasi menggunakannya untuk membangun dan mengontrol grafik filter. Filter Graph Manager juga menangani sinkronisasi, pemberitahuan peristiwa, dan aspek lain dari mengontrol grafik filter. Buat objek ini dengan memanggil CoCreateInstance.

CLSID

Ada dua CLSID untuk membuat Filter Graph Manager:

CLSID Deskripsi
CLSID_FilterGraph Membuat Filter Graph Manager pada utas pekerja bersama.
CLSID_FilterGraphNoThread Membuat Filter Graph Manager pada utas aplikasi.

 

Umumnya, aplikasi harus menggunakan CLSID_FilterGraph. Kedua CLSID membuat objek yang sama, tetapi menggunakan model utas yang berbeda:

  • CLSID_FilterGraph membuat Filter Graph Manager pada utas pekerja, yang dibagikan oleh semua instans CLSID_FilterGraph dalam proses yang sama. Utas mengirimkan pesan yang dikirim oleh filter, dan mengontrol masa pakai jendela apa pun yang dibuat oleh filter.
  • CLSID_FilterGraphNoThread membuat Filter Graph Manager pada utas aplikasi. Jika Anda menggunakan CLSID ini, utas yang memanggil CoCreateInstance harus memiliki perulangan pesan yang mengirimkan pesan; jika tidak, kebuntuan dapat terjadi. Selain itu, sebelum utas aplikasi keluar, aplikasi harus melepaskan Filter Graph Manager dan semua objek grafik (seperti filter, pin, jam referensi, dan sebagainya).

Antarmuka

Filter Graph Manager mengekspos antarmuka berikut:

Objek DirectShow