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

Статья
02/07/2025

Структура 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 (include Ksmedia.h)

См. также

KSAUDIO_MICROPHONE_COORDINATES

Поделиться через