Knoten und Verbindungen

Der Filter stellt eine Beschreibung seiner Topologieknoten in Form eines Arrays von Knotendeskriptoren (PCNODE_DESCRIPTOR Strukturen) bereit. Jeder Deskriptor im Array beschreibt einen einzelnen Knoten und enthält eine GUID, die den Knotentyp angibt (z. B. KSNODETYPE_REVERB). Eine Liste der Standardknotentypen, die für Audiogeräte definiert sind, finden Sie unter Audiotopologieknoten.

Der Filter identifiziert jeden seiner Knoten durch den Index des Knotens im Deskriptor-Array. Wenn Sie z. B. eine knotenspezifische Eigenschaftsanforderung an einen Filter oder an einen bestimmten Pin für einen Filter senden, enthält ein Client die Knoten-ID (den Arrayindex) in der Anforderung, um den Zielknoten zu identifizieren.

Der Filter enthält eine Beschreibung seiner internen Verbindungen in Form eines Arrays von Verbindungsdeskriptoren (PCCONNECTION_DESCRIPTOR Strukturen). Jeder Deskriptor beschreibt eine der internen Verbindungen des Filters. Ein Deskriptor kann entweder eine Verbindung zwischen einem Pin und einem Knoten oder eine Verbindung zwischen zwei Knoten beschreiben.

Die Knoten und Verbindungen, die der Filter gemeinsam verfügbar macht, definieren die interne Topologie des Filters. Die Topologie ist eine Zuordnung des internen Layouts des Audiogeräts und sollte die Organisation der Hardware, die sie darstellt, genau widerspiegeln. Die Microsoft Windows Multimedia Mixer-API übersetzt z. B. die internen Verbindungen des Filters in Mischerlinien und deren Knoten in Steuerelemente in den Mischerzeilen (siehe Kernel Streaming Topology to Audio Mixer API Translation). Alle Ungenauigkeiten in der internen Topologie des Filters werden in der Mischerliniendarstellung widergespiegelt und können Fehler oder unerwartetes Verhalten in einer Anwendung verursachen, die die Mixer-API verwendet.