Узлы и подключения

Фильтр предоставляет описание узлов топологии в виде массива дескрипторов узлов (PCNODE_DESCRIPTOR структур). Каждый дескриптор в массиве описывает один узел и содержит GUID, указывающий тип узла (например, KSNODETYPE_REVERB). Список стандартных типов узлов, определенных для звуковых устройств, см. в разделе Узлы топологии звука.

Фильтр идентифицирует каждый из своих узлов по индексу узла в массиве дескрипторов. Например, при отправке запроса на свойство конкретного узла в фильтр или к определенному закреплению на фильтре клиент включает идентификатор узла (индекс массива) в запрос для идентификации целевого узла.

Фильтр предоставляет описание своих внутренних соединений в виде массива дескрипторов соединений (PCCONNECTION_DESCRIPTOR структур). Каждый дескриптор описывает одно из внутренних подключений фильтра. Дескриптор может описывать соединение между закреплением и узлом или соединение между двумя узлами.

Узлы и соединения, предоставляемые фильтром, определяют внутреннюю топологию фильтра. Топология — это карта внутреннего макета звукового устройства и должна точно отражать организацию оборудования, которое оно представляет. Api микшера Microsoft Windows Multimedia, например, преобразует внутренние подключения фильтра в линии микшера, а его узлы в элементы управления в линиях микшера (см . раздел Топология потоковой передачи ядра в преобразование API микшера аудио). Любые неточности во внутренней топологии фильтра отражаются в представлении линии микшера и могут привести к ошибкам или непредвиденному поведению приложения, использующего API микшера.