Nodi e connessioni

Il filtro fornisce una descrizione dei nodi della topologia sotto forma di una matrice di descrittori di nodi (strutture PCNODE_DESCRIPTOR ). Ogni descrittore nella matrice descrive un singolo nodo e contiene un GUID che specifica il tipo di nodo , ad esempio KSNODETYPE_REVERB. Per un elenco dei tipi di nodo standard definiti per i dispositivi audio, vedere Nodi topologia audio.

Il filtro identifica ognuno dei relativi nodi in base all'indice del nodo nella matrice descrittore. Ad esempio, quando si invia una richiesta di proprietà specifica del nodo a un filtro o a un particolare pin su un filtro, un client include l'ID nodo (indice matrice) nella richiesta per identificare il nodo di destinazione.

Il filtro fornisce una descrizione delle connessioni interne sotto forma di una matrice di descrittori di connessione (PCCONNECTION_DESCRIPTOR strutture). Ogni descrittore descrive una delle connessioni interne del filtro. Un descrittore può descrivere una connessione tra un pin e un nodo o una connessione tra due nodi.

I nodi e le connessioni che il filtro espone insieme definiscono la topologia interna del filtro. La topologia è una mappa del layout interno del dispositivo audio e deve riflettere in modo accurato l'organizzazione dell'hardware che rappresenta. L'API del mixer multimediale Di Microsoft Windows, ad esempio, converte le connessioni interne del filtro in linee di mixer e i relativi nodi nei controlli sulle linee del mixer (vedere Topologia di streaming del kernel a Traduzione API Audio Mixer). Eventuali errori nella topologia interna del filtro si riflettono nella rappresentazione della linea di mixer e possono causare errori o comportamenti imprevisti in un'applicazione che usa l'API mixer.