KSPROPERTY_SYSAUDIO_SELECT_GRAPH

Свойство KSPROPERTY_SYSAUDIO_SELECT_GRAPH используется для явного включения необязательного узла в граф, который SysAudio создает для экземпляра закрепления на виртуальном звуковом устройстве.

Сводная таблица использования

Получить Присвойте параметру Назначение Тип дескриптора свойства Тип значения свойства

Нет

Да

Фильтр

SYSAUDIO_SELECT_GRAPH

Нет

Дескриптор свойства (данные экземпляра) — это структура типа SYSAUDIO_SELECT_GRAPH, которая задает свойство, идентификатор закрепления и идентификатор узла. Свойство задается внедренной структурой типа KSPROPERTY. Идентификатор закрепления — это индекс, определяющий фабрику контактов в фильтре KS, который упаковывает виртуальное звуковое устройство. Идентификатор узла — это индекс, определяющий необязательный узел в пути к данным указанного контакта. Дополнительные сведения см. в разделе "Примечания".

Для этого свойства не определено значение свойства (данные операции). Укажите в качестве указателя буфера значения свойства значение NULL , а его размер — нуль.

Возвращаемое значение

Запрос свойства KSPROPERTY_SYSAUDIO_SELECT_GRAPH возвращает STATUS_SUCCESS, чтобы указать, что он успешно завершен. В противном случае запрос возвращает соответствующий код состояния ошибки.

Комментарии

Это свойство обычно используется для принудительного ввода узла AEC в граф для экземпляра закрепления.

При создании экземпляра маркера отрисовки в фильтре для виртуального звукового устройства SysAudio начинается с контакта и по умолчанию выбирает граф, представляющий самый простой путь через фильтр. Этот граф исключает любые необязательные узлы, такие как элементы управления AEC.

Вы можете переопределить поведение SysAudio по умолчанию, отправив SysAudio KSPROPERTY_SYSAUDIO_SELECT_GRAPH запрос set-property, указывающий необязательный узел, который должен быть включен в граф. Когда SysAudio впоследствии создаст экземпляр контакта, граф пин-кода будет включать необязательный узел, указанный в запросе.

Запрос KSPROPERTY_SYSAUDIO_SELECT_GRAPH set-property влияет только на экземпляры закрепления, созданные после запроса. Запрос не влияет на все ранее созданные экземпляры контактов.

Требования

Заголовок

Ksmedia.h (включая Ksmedia.h)

См. также

SYSAUDIO_SELECT_GRAPH

KSPROPERTY