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 | Linear |
| KSMICARRAY_MICARRAYTYPE_PLANAR | 平面 |
| KSMICARRAY_MICARRAYTYPE_3D | 3D |
wVerticalAngleBegin
マイク配列の作業ボリュームの開始の垂直角度を指定します。
wVerticalAngleEnd
マイク配列の作業ボリュームの終点の垂直角度を指定します。
wHorizontalAngleBegin
Work Volume HorizontalAngle Begin
wHorizontalAngleEnd
作業量水平アングルエンド
usFrequencyBandLo
マイク配列の周波数範囲の下端を指定します。
usFrequencyBandHi
マイク配列の周波数範囲の上端を指定します。
usNumberOfMicrophones
マイク配列内のマイクの数を指定します。
KsMicCoord[1]
配列内のマイクの位置を含むKSAUDIO_MICROPHONE_COORDINATES構造体の配列を指定します。
注釈
すべての角度の値は、ラジアンの 1/10000 の単位で表されます。 たとえば、3.1416 ラジアンは 31416 単位で表されます。 使用できる値の範囲は -31416 ~ 31416 です。
すべての座標値はミリメートルで表されます。 許容される値の範囲は-32768 ~ 32767 です。値は 32767 です。
周波数の値は、ヘルツ (Hz) で表されます。
Windows でマイク配列を処理する方法の詳細については、Windows ホワイト ペーパーの マイク配列のサポートに 関するページを参照してください。
要件
| 要件 | 値 |
|---|---|
| Header | ksmedia.h (Ksmedia.h を含む) |