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) |