KSPROPERTY_AUDIO_MIX_LEVEL_TABLE
Свойство KSPROPERTY_AUDIO_MIX_LEVEL_TABLE задает уровни сочетания для узла супермиксера (KSNODETYPE_SUPERMIX). Он предоставляет сведения для всех входных и выходных каналов.
Сводная таблица использования
| Get | Set | целевого объекта | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
да |
Необязательно |
Pin |
Массив структур KSAUDIO_MIXLEVEL |
Узел необходим для реализации поддержки запросов KSPROPERTY_TYPE_GET. Однако поддержка KSPROPERTY_TYPE_SET запросов является необязательной.
Значение свойства (данные операции) — это массив KSAUDIO_MIXLEVEL структур, указывающий уровни смешивания для всех путей ввода-вывода M*N в узле супермиксера с входными каналами M и N выходными каналами. Массив содержит элементы M*N:
KSAUDIO_MIXLEVEL MixLevel[M*N];
В следующей таблице показано сопоставление элементов массива с путями ввода-вывода узла супермиксера.
| Элемент Array | Путь Input-Output |
|---|---|
MixLevel[0] |
Входной канал 0 в выходной канал 0 |
MixLevel[1] |
Входной канал 0 в выходной канал 1 |
MixLevel[N-1] |
Входной канал 0 в выходной канал N-1 |
MixLevel[N] |
Входной канал 1 — выходной канал 0 |
MixLevel[N+1] |
Входной канал 1 в выходной канал 1 |
MixLevel[2N-1] |
Входной канал 1 в выходной канал N-1 |
MixLevel[M*N-1] |
Входной канал M-1 в выходной канал N-1 |
На следующем рисунке показано сопоставление элементов массива MixLevel с путями ввода-вывода. Индекс элемента массива MixLevel, управляющего каждым путем ввода-вывода, отображается в квадратных скобках.
Если ни один путь не подключает канал ввода i к выходному каналу j, фильтр должен задать для элемента Mute элемента массива MixLevel[i*N+j] значение TRUE.
Размер массива KSAUDIO_MIXLEVEL вычисляется на основе структуры KSAUDIO_MIXCAP_TABLE , полученной из KSPROPERTY_AUDIO_MIX_LEVEL_CAPS. Если элементы InputChannels и OutputChannels структуры содержат значения m и n, размер массива равен
М * N * sizeof(KSAUDIO_MIXLEVEL)
Возвращаемое значение
Запрос свойства KSPROPERTY_AUDIO_MIX_LEVEL_TABLE возвращает STATUS_SUCCESS, указывающий на успешное выполнение. В противном случае запрос возвращает соответствующий код состояния ошибки.
Комментарии
Фильтр завершится успешно KSPROPERTY_AUDIO_MIX_LEVEL_TABLE запросом set-property, который задает значение уровня набора (элемент уровня KSAUDIO_MIXLEVEL), которое выходит за пределы диапазона фильтра, но автоматически зажимает значение в поддерживаемом диапазоне. Однако в последующем запросе на получение этого свойства фильтр выдаст фактическое используемое значение.
Требования
Заголовок |
Ksmedia.h (включая Ksmedia.h) |