structure KSAUDIO_MIC_ARRAY_GEOMETRY (ksmedia.h)

Article
02/07/2025

La structure KSAUDIO_MIC_ARRAY_GEOMETRY spécifie le type et la géométrie du tableau de microphones. Le usNumberOfMicrophones membre indique le nombre de microphones dans le tableau physique. Le membre KsMicCoord est une variable de type KSAUDIO_MICROPHONE_COORDINATES et est un tableau de structures. Le nombre d’entrées de ce tableau est donné par la valeur de l'usNumberOfMicrophones membre.

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 en cours d’utilisation. 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	Planaire
KSMICARRAY_MICARRAYTYPE_3D	3D

wVerticalAngleBegin

Spécifie l’angle vertical du début du volume de travail du tableau de microphones.

wVerticalAngleEnd

Spécifie l’angle vertical de la fin du volume de travail du tableau de microphones.

wHorizontalAngleBegin

Début horizontal du volume de travail

wHorizontalAngleEnd

Fin horizontale du volume de travail

usFrequencyBandLo

Spécifie le bas de la plage de fréquences pour le tableau de microphones.

usFrequencyBandHi

Spécifie le haut de la plage de fréquences pour le tableau de microphones.

usNumberOfMicrophones

Spécifie le nombre de microphones dans le tableau 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, les radians 3.1416 sont exprimés sous la forme de 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 vont de -32768 à 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 prise en charge du tableau de microphones dans Windows livre blanc.

Exigences

Exigence	Valeur
d’en-tête	ksmedia.h (include Ksmedia.h)

Voir aussi

KSAUDIO_MICROPHONE_COORDINATES

Partager via