Nodos y conexiones

El filtro proporciona una descripción de sus nodos de topología en forma de una matriz de descriptores de nodo (estructuras PCNODE_DESCRIPTOR ). Cada descriptor de la matriz describe un único nodo y contiene un GUID que especifica el tipo de nodo (por ejemplo, KSNODETYPE_REVERB). Para obtener una lista de los tipos de nodo estándar definidos para dispositivos de audio, consulte Nodos de topología de audio.

El filtro identifica cada uno de sus nodos por el índice del nodo en la matriz descriptor. Por ejemplo, al enviar una solicitud de propiedad específica del nodo a un filtro o a un pin determinado en un filtro, un cliente incluye el identificador de nodo (el índice de matriz) en la solicitud para identificar el nodo de destino.

El filtro proporciona una descripción de sus conexiones internas en forma de una matriz de descriptores de conexión (estructuras PCCONNECTION_DESCRIPTOR ). Cada descriptor describe una de las conexiones internas del filtro. Un descriptor puede describir una conexión entre un pin y un nodo o una conexión entre dos nodos.

Los nodos y las conexiones que expone el filtro juntos definen la topología interna del filtro. La topología es un mapa del diseño interno del dispositivo de audio y debe reflejar con precisión la organización del hardware que representa. La API de mezclador multimedia de Microsoft Windows, por ejemplo, traduce las conexiones internas del filtro en líneas de mezclador y sus nodos en controles en las líneas mezcladoras (consulte Kernel Streaming Topology to Audio Mixer API Translation). Cualquier inexactitud en la topología interna del filtro se refleja en la representación de la línea mezcladora y puede provocar errores o un comportamiento inesperado en una aplicación que usa la API mezcladora.