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 anhand des Index des Knotens im Deskriptorarray. Wenn beispielsweise eine knotenspezifische Eigenschaftsanforderung an einen Filter oder an einen bestimmten Pin in einem Filter gesendet wird, schließt ein Client die Knoten-ID (den Arrayindex) in die Anforderung ein, um den Zielknoten zu identifizieren.

Der Filter stellt eine Beschreibung seiner internen Verbindungen in Form eines Arrays von Verbindungsdeskriptoren (PCCONNECTION_DESCRIPTOR-Strukturen ) bereit. 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 zusammen verfügbar macht, definieren die interne Topologie des Filters. Die Topologie ist eine Zuordnung des internen Layouts des Audiogeräts und sollte die organization der Hardware, die es darstellt, genau widerspiegeln. Die Microsoft Windows Multimedia-Mixer-API übersetzt beispielsweise die internen Verbindungen des Filters in Mischerlinien und seine Knoten in Steuerelemente für die Mixerlinien (siehe Api-Übersetzung von Kernelstreamingtopologie zu Audiomischer). 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.