Filter KS

Filter adalah sekelompok simpul yang merangkum tugas pemrosesan yang akan dilakukan pada aliran data. Pin berfungsi sebagai saluran input dan output pada filter.

Filter sederhana dapat berisi satu pin sink data dan satu pin sumber data. Filter menerima data masuk pada pin sink data, memprosesnya secara internal, dan menulis ke pin sumber data. Pada gambar berikut, pin ditampilkan sebagai segmen garis tebal. Secara internal, filter menyambungkan pin sink data ke unit pemrosesan internal, simpul, yang pada gilirannya terhubung ke pin sumber data.

Perangkat lain mungkin menggabungkan atau membagi aliran data di antara pin. Misalnya, mixer audio mendukung beberapa pin sink data. Mixer menggabungkannya menjadi satu aliran, dan menulis aliran tersebut ke pin sumber data. Ilustrasi berikut menunjukkan aliran data.

Grafik menjelaskan hubungan internal antara pin filter. Filter yang lebih rumit mungkin merangkum beberapa simpul yang mengubah data yang mengalir melalui filter.

Filter menentukan koneksi internal antara pin dan simpul internal dengan menggunakan kumpulan properti KSPROPSETID_Topology .

Properti KSPROPERTY_TOPOLOGY_CONNECTIONS meminta semua koneksi antara simpul filter KS. Properti ini mengembalikan array KSTOPOLOGY_CONNECTION. Setiap struktur KSTOPOLOGY_CONNECTION mewakili satu koneksi jalur data di dalam filter. Dalam diagram mixer di atas, urutan struktur KSTOPOLOGY_CONNECTION bisa sebagai berikut:

//    FromNode,       FromNodePin,     ToNode,        ToNodePin,
{
 {  KSFILTER_NODE,        0,            0,               0     },
 {       0,               1,       KSFILTER_NODE,        1     }
}