структура KSAUDIO_MIC_ARRAY_GEOMETRY (ksmedia.h)

  • Статья

Структура KSAUDIO_MIC_ARRAY_GEOMETRY определяет тип и геометрию микрофонного массива. Элемент usNumberOfMicrophones указывает количество микрофонов в физическом массиве. Элемент KsMicCoord является переменной типа KSAUDIO_MICROPHONE_COORDINATES и массивом структур. Количество записей в этом массиве определяется значением элемента usNumberOfMicrophones .

Синтаксис

typedef struct {
  USHORT                         usVersion;
  USHORT                         usMicArrayType;
  SHORT                          wVerticalAngleBegin;
  SHORT                          wVerticalAngleEnd;
  SHORT                          wHorizontalAngleBegin;
  SHORT                          wHorizontalAngleEnd;
  USHORT                         usFrequencyBandLo;
  USHORT                         usFrequencyBandHi;
  USHORT                         usNumberOfMicrophones;
  KSAUDIO_MICROPHONE_COORDINATES KsMicCoord[1];
} KSAUDIO_MIC_ARRAY_GEOMETRY, *PKSAUDIO_MIC_ARRAY_GEOMETRY;

Члены

usVersion

Указывает номер версии структуры KSAUDIO_MIC_ARRAY_GEOMETRY. Этот член является значением BCD и в настоящее время имеет значение 0x0100, что представляет номер версии 1.0.

usMicArrayType

Указывает тип используемого микрофонного массива. Этот элемент может быть любым из значений перечисления KSMICARRAY_MICARRAYTYPE, показанных в следующей таблице.

Значение Тип массива микрофона
KSMICARRAY_MICARRAYTYPE_LINEAR Линейная
KSMICARRAY_MICARRAYTYPE_PLANAR Плоские
KSMICARRAY_MICARRAYTYPE_3D 3D

wVerticalAngleBegin

Задает вертикальный угол начала рабочего громкости микрофонного массива.

wVerticalAngleEnd

Задает вертикальный угол конца рабочего громкости микрофонного массива.

wHorizontalAngleBegin

Начало горизонтальной области работы

wHorizontalAngleEnd

Рабочий том По горизонталиКонечная конечная

usFrequencyBandLo

Задает низкий предел диапазона частот для массива микрофонов.

usFrequencyBandHi

Задает высокий предел диапазона частот для массива микрофонов.

usNumberOfMicrophones

Указывает количество микрофонов в массиве микрофонов.

KsMicCoord[1]

Задает массив структур KSAUDIO_MICROPHONE_COORDINATES, содержащих расположения микрофонов в массиве.

Комментарии

Все значения угла выражаются в единицах 1/10000 от радиана. Например, 3,1416 радиан выражается как 31416 единиц. Допустимые значения варьируются от –31416 до 31416 единиц.

Все координатные значения выражаются в миллиметрах. Допустимые значения варьируются от –32768 до 32767 включительно.

Значения частоты выражаются в герцах (Гц).

Дополнительные сведения об обработке микрофонного массива в Windows см. в техническом документе Поддержка массива микрофонов в Windows .

Требования

Требование Значение
Заголовок ksmedia.h (включая Ksmedia.h)

См. также раздел

KSAUDIO_MICROPHONE_COORDINATES