KSPROPERTY_AUDIO_CHANNEL_CONFIG

Статья
06/15/2023

Свойство KSPROPERTY_AUDIO_CHANNEL_CONFIG указывает фактическое пространственное размещение каналов в аудиопотоке, выводимом узлом.

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

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

Значение свойства (данные операции) — это структура типа KSAUDIO_CHANNEL_CONFIG. Эта структура определяет каналы, содержащиеся в потоке вывода, и назначение этих каналов динамикам.

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

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

При использовании в качестве свойства узла приложения уровня данных (KSNODETYPE_DAC) или трехмерного узла (KSNODETYPE_3D_EFFECTS) свойство KSPROPERTY_AUDIO_CHANNEL_CONFIG указывает конфигурацию динамиков DirectSound. Для конфигураций стереоколонок это свойство используется в сочетании со свойством KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY , которое различает наушники и несколько конфигураций стерео динамиков. Дополнительные сведения о конфигурациях говорящего см. в разделе Параметры DirectSound Speaker-Configuration.

DirectSound также использует свойство KSPROPERTY_AUDIO_CHANNEL_CONFIG для запроса к узлу pan для настройки канала. Узел сдвига — это второй узел тома (KSNODETYPE_VOLUME) на контакте микшера, который соответствует требованиям к упорядочению узлов DirectSound. Реализация метода IDirectSoundBuffer::SetPan в DirectSound (описанная в документации по Microsoft Windows SDK) использует свойство KSPROPERTY_AUDIO_VOLUMELEVEL узла сдвига для управления сдвигом.

DirectSound рассматривает KSPROPERTY_AUDIO_CHANNEL_CONFIG как свойство фильтра на узле приложения уровня данных, а также как свойство закрепления на томах и трехмерных узлах.

Клиенты также используют это свойство для выбора формата потока, который выводит узел KSNODETYPE_PROLOGIC_DECODER .