Nós e conexões

O filtro fornece uma descrição de seus nós de topologia na forma de uma matriz de descritores de nó (estruturas PCNODE_DESCRIPTOR ). Cada descritor na matriz descreve um único nó e contém um GUID que especifica o tipo de nó (por exemplo, KSNODETYPE_REVERB). Para obter uma lista dos tipos de nó padrão definidos para dispositivos de áudio, consulte Nós de topologia de áudio.

O filtro identifica cada um de seus nós pelo índice do nó na matriz do descritor. Por exemplo, ao enviar uma solicitação de propriedade específica do nó para um filtro ou para um determinado pino em um filtro, um cliente inclui a ID do nó (o índice da matriz) na solicitação para identificar o nó de destino.

O filtro fornece uma descrição de suas conexões internas na forma de uma matriz de descritores de conexão (estruturas PCCONNECTION_DESCRIPTOR ). Cada descritor descreve uma das conexões internas do filtro. Um descritor pode descrever uma conexão entre um pin e um nó ou uma conexão entre dois nós.

Os nós e as conexões que o filtro expõe juntos definem a topologia interna do filtro. A topologia é um mapa do layout interno do dispositivo de áudio e deve refletir com precisão a organização do hardware que ele representa. A API de mixer multimídia do Microsoft Windows, por exemplo, converte as conexões internas do filtro em linhas de mixer e seus nós em controles nas linhas do mixer (consulte Topologia de Streaming de Kernel para Tradução de API do Mixer de Áudio). Quaisquer imprecisões na topologia interna do filtro são refletidas na representação de linha de mixer e podem causar erros ou comportamento inesperado em um aplicativo que usa a API do mixer.