Nœuds et connexions

Le filtre fournit une description de ses nœuds de topologie sous la forme d’un tableau de descripteurs de nœuds (structures PCNODE_DESCRIPTOR ). Chaque descripteur dans le tableau décrit un nœud unique et contient un GUID qui spécifie le type de nœud (par exemple, KSNODETYPE_REVERB). Pour obtenir la liste des types de nœuds standard définis pour les périphériques audio, consultez Nœuds de topologie audio.

Le filtre identifie chacun de ses nœuds par l’index du nœud dans le tableau de descripteur. Par exemple, lors de l’envoi d’une demande de propriété spécifique à un nœud à un filtre ou à une broche particulière sur un filtre, un client inclut l’ID de nœud (index de tableau) dans la demande afin d’identifier le nœud cible.

Le filtre fournit une description de ses connexions internes sous la forme d’un tableau de descripteurs de connexion (structures PCCONNECTION_DESCRIPTOR ). Chaque descripteur décrit l’une des connexions internes du filtre. Un descripteur peut soit décrire une connexion entre une broche et un nœud, soit une connexion entre deux nœuds.

Les nœuds et les connexions que le filtre expose ensemble définissent la topologie interne du filtre. La topologie est une carte de la disposition interne de l’appareil audio et doit refléter avec précision la organization du matériel qu’elle représente. Par exemple, l’API mixer Multimédia Microsoft Windows traduit les connexions internes du filtre en lignes de mélangeur et ses nœuds en contrôles sur les lignes de mélangeur (voir Kernel Streaming Topology to Audio Mixer API Translation). Toutes les inexactitudes dans la topologie interne du filtre sont reflétées dans la représentation de la ligne de mixage et peuvent entraîner des erreurs ou un comportement inattendu dans une application qui utilise l’API mixer.