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 値であり、現在はバージョン番号 1.0 を表す 0x0100 に設定されています。

usMicArrayType

使用中のマイク配列の種類を指定します。 このメンバーには、次の表に示すKSMICARRAY_MICARRAYTYPE列挙値のいずれかを指定できます。

価値	マイク配列の種類
KSMICARRAY_MICARRAYTYPE_LINEAR	リニア
KSMICARRAY_MICARRAYTYPE_PLANAR	平面
KSMICARRAY_MICARRAYTYPE_3D	3D

wVerticalAngleBegin

マイク配列の作業ボリュームの開始の垂直角度を指定します。

wVerticalAngleEnd

マイク配列の作業ボリュームの終点の垂直角度を指定します。

wHorizontalAngleBegin

作業量 HorizontalAngle Begin

wHorizontalAngleEnd

ワークボリューム水平アングルエンド

usFrequencyBandLo

マイク配列の周波数範囲の下限を指定します。

usFrequencyBandHi

マイク配列の周波数範囲のハイエンドを指定します。

usNumberOfMicrophones

マイク配列内のマイクの数を指定します。

KsMicCoord[1]

配列内のマイクの位置を含むKSAUDIO_MICROPHONE_COORDINATES構造体の配列を指定します。

備考

すべての角度の値は、ラジアンの 1/10000 の単位で表されます。 たとえば、3.1416 ラジアンは 31416 単位で表されます。 使用可能な値の範囲は、-31416 から 31416 単位です。

すべての座標値はミリメートルで表されます。 使用できる値の範囲は、-32768 ~ 32767 です。

周波数の値は、ヘルツ (Hz) で表されます。

Windows でマイク配列を処理する方法の詳細については、Windows ホワイト ペーパーの マイク配列のサポートを参照してください。

必要条件

要件	価値
ヘッダー	ksmedia.h (Ksmedia.h を含む)

関連項目

KSAUDIO_MICROPHONE_COORDINATES