Węzły i połączenia

Filtr dostarcza opis swoich węzłów topologicznych w postaci tablicy deskryptorów węzłowych (struktur PCNODE_DESCRIPTOR). Każdy deskryptor w tablicy opisuje jeden węzeł i zawiera identyfikator GUID określający typ węzła (na przykład KSNODETYPE_REVERB). Aby uzyskać listę standardowych typów węzłów zdefiniowanych dla urządzeń audio, zobacz Węzły topologii audio.

Filtr identyfikuje każdy z jego węzłów według indeksu węzła w tablicy deskryptora. Na przykład podczas wysyłania żądania właściwości specyficznej dla węzła do filtru lub do określonego pinu filtru klient zawiera identyfikator węzła (indeks tablicy) w żądaniu w celu zidentyfikowania węzła docelowego.

Filtr zawiera opis swoich połączeń wewnętrznych w postaci tablicy deskryptorów połączeń (PCCONNECTION_DESCRIPTOR struktur). Każdy deskryptor opisuje jedno z wewnętrznych połączeń filtru. Deskryptor może opisać połączenie między pinem a węzłem lub połączenie między dwoma węzłami.

Węzły i połączenia, które filtr uwidacznia razem, definiują wewnętrzną topologię filtru. Topologia jest mapą wewnętrznego układu urządzenia audio i powinna dokładnie odzwierciedlać organizację sprzętu, który reprezentuje. Interfejs API miksera multimediów systemu Microsoft Windows, na przykład, przekształca wewnętrzne połączenia filtru w linie miksera, a jego węzły w kontrolki na liniach miksera (zobacz Tłumaczenie topologii jądrowego przesyłania strumieniowego na interfejs API miksera audio). Wszelkie niedokładności w wewnętrznej topologii filtru są odzwierciedlane w reprezentacji linii miksera i mogą powodować błędy lub nieoczekiwane zachowanie w aplikacji korzystającej z interfejsu API miksera.