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 三维

wVerticalAngleBegin

指定麦克风阵列工作音量开始的垂直角度。

wVerticalAngleEnd

指定麦克风阵列工作音量末尾的垂直角度。

wHorizontalAngleBegin

工作卷 HorizontalAngle Begin

wHorizontalAngleEnd

工作卷 HorizontalAngle End

usFrequencyBandLo

指定麦克风阵列的频率范围的低端。

usFrequencyBandHi

指定麦克风阵列的频率范围的高端。

usNumberOfMicrophones

指定麦克风阵列中的麦克风数。

KsMicCoord[1]

指定包含数组中麦克风位置的KSAUDIO_MICROPHONE_COORDINATES结构的数组。

注解

所有角度值都以弧度 1/10000 的单位表示。 例如，3.1416 弧度表示为 31416 个单位。 可接受的值范围为 -31416 到 31416 单位。

所有坐标值都以毫米表示。 可接受的值范围为 -32768 到 32767（含 ）。

频率值以 Hertz (Hz) 表示。

有关如何在 Windows 中处理麦克风阵列的详细信息，请参阅 Windows 中的麦克风阵列支持 白皮书。

要求

要求 值
Header ksmedia.h (包括 Ksmedia.h)

另请参阅

KSAUDIO_MICROPHONE_COORDINATES