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
Work Volume HorizontalAngle Begin
wHorizontalAngleEnd
工作音量 HorizontalAngle 結束
usFrequencyBandLo
指定麥克風陣組頻率範圍的低端。
usFrequencyBandHi
指定麥克風陣組頻率範圍的高階。
usNumberOfMicrophones
指定麥克風陣列中的麥克風數目。
KsMicCoord[1]
指定包含數位中麥克風位置之KSAUDIO_MICROPHONE_COORDINATES結構的陣列。
備註
所有角度值都會以弧度 1/10000 的單位表示。 例如,3.1416 弧度是以 31416 單位表示。 可接受的值範圍從 -31416 到 31416 單位。
所有座標值都會以公厘表示。 可接受的值範圍從 -32768 到 32767,包含。
頻率值以 Hertz (Hz) 表示。
如需如何在 Windows 中處理麥克風陣列的詳細資訊,請參閱 Windows 白皮書中的麥克風陣列支援 。
規格需求
需求 | 值 |
---|---|
標頭 | ksmedia.h (包含 Ksmedia.h) |