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)

另請參閱

KSAUDIO_MICROPHONE_COORDINATES