KSAUDIO_MIC_ARRAY_GEOMETRY structure (ksmedia.h)
La structure KSAUDIO_MIC_ARRAY_GEOMETRY spécifie le type et la géométrie du réseau de microphones. Le membre usNumberOfMicrophones indique le nombre de microphones dans le tableau physique. Le membre KsMicCoord est une variable de type KSAUDIO_MICROPHONE_COORDINATES et un tableau de structures. Le nombre d’entrées dans ce tableau est donné par la valeur du membre usNumberOfMicrophones .
Syntaxe
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;
Membres
usVersion
Spécifie le numéro de version de la structure KSAUDIO_MIC_ARRAY_GEOMETRY. Ce membre est une valeur BCD et est actuellement défini sur 0x0100, qui représente un numéro de version de 1.0.
usMicArrayType
Spécifie le type de tableau de microphones utilisé. Ce membre peut être l’une des valeurs d’énumération KSMICARRAY_MICARRAYTYPE indiquées dans le tableau suivant.
| Valeur | Type de tableau de microphones |
|---|---|
| KSMICARRAY_MICARRAYTYPE_LINEAR | Linéaire |
| KSMICARRAY_MICARRAYTYPE_PLANAR | Planar |
| KSMICARRAY_MICARRAYTYPE_3D | 3D |
wVerticalAngleBegin
Spécifie l’angle vertical du début du volume de travail du réseau de microphones.
wVerticalAngleEnd
Spécifie l’angle vertical de la fin du volume de travail du réseau de microphones.
wHorizontalAngleBegin
Volume de travail horizontalDécouvrez le volume de travail
wHorizontalAngleEnd
Volume de travail HorizontalAngle End
usFrequencyBandLo
Spécifie l’extrémité inférieure de la plage de fréquences pour le réseau de microphones.
usFrequencyBandHi
Spécifie l’extrémité supérieure de la plage de fréquences pour le réseau de microphones.
usNumberOfMicrophones
Spécifie le nombre de microphones dans le réseau de microphones.
KsMicCoord[1]
Spécifie le tableau de structures KSAUDIO_MICROPHONE_COORDINATES qui contient les emplacements des microphones dans le tableau.
Remarques
Toutes les valeurs d’angle sont exprimées en unités de 1/10000e d’un radian. Par exemple, 3,1416 radians est exprimé en 31416 unités. Les valeurs acceptables vont de -31416 à 31416 unités.
Toutes les valeurs de coordonnées sont exprimées en millimètres. Les valeurs acceptables sont comprises entre -32768 et 32767, inclus.
Les valeurs de fréquence sont exprimées en Hertz (Hz).
Pour plus d’informations sur le traitement d’un tableau de microphones dans Windows, consultez le livre blanc Prise en charge du tableau de microphones dans Windows .
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ksmedia.h (incluez Ksmedia.h) |