estructura KSAUDIO_MIC_ARRAY_GEOMETRY (ksmedia.h)

La estructura KSAUDIO_MIC_ARRAY_GEOMETRY especifica el tipo y la geometría de la matriz de micrófonos. El miembro usNumberOfMicrophones indica el número de micrófonos de la matriz física. El miembro KsMicCoord es una variable de tipo KSAUDIO_MICROPHONE_COORDINATES y es una matriz de estructuras. El número de entradas de esta matriz se proporciona mediante el valor del miembro usNumberOfMicrophones .

Sintaxis

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;

Miembros

usVersion

Especifica el número de versión de la estructura KSAUDIO_MIC_ARRAY_GEOMETRY. Este miembro es un valor BCD y actualmente se establece en 0x0100, que representa un número de versión de 1.0.

usMicArrayType

Especifica el tipo de matriz de micrófonos en uso. Este miembro puede ser cualquiera de los valores de enumeración de KSMICARRAY_MICARRAYTYPE que se muestran en la tabla siguiente.

Valor	Tipo de matriz de micrófono
KSMICARRAY_MICARRAYTYPE_LINEAR	Lineal
KSMICARRAY_MICARRAYTYPE_PLANAR	Planar
KSMICARRAY_MICARRAYTYPE_3D	3D

wVerticalAngleBegin

Especifica el ángulo vertical del inicio del volumen de trabajo de la matriz de micrófonos.

wVerticalAngleEnd

Especifica el ángulo vertical del final del volumen de trabajo de la matriz de micrófonos.

wHorizontalAngleBegin

Volumen de trabajo HorizontalAngle Begin

wHorizontalAngleEnd

Fin horizontal del volumen de trabajoAngle

usFrequencyBandLo

Especifica el extremo inferior del intervalo de frecuencia de la matriz de micrófonos.

usFrequencyBandHi

Especifica el extremo superior del intervalo de frecuencia de la matriz de micrófonos.

usNumberOfMicrophones

Especifica el número de micrófonos de la matriz de micrófonos.

KsMicCoord[1]

Especifica la matriz de estructuras de KSAUDIO_MICROPHONE_COORDINATES que contiene las ubicaciones de los micrófonos de la matriz.

Comentarios

Todos los valores angulares se expresan en unidades de 1/10000th de un radian. Por ejemplo, 3,1416 radianes se expresa como 31416 unidades. Los valores aceptables oscilan entre -31416 y 31416 unidades.

Todos los valores de coordenada se expresan en milímetros. Los valores aceptables oscilan entre -32768 y 32767, ambos incluidos.

Los valores de frecuencia se expresan en Hertz (Hz).

Para obtener más información sobre cómo procesar una matriz de micrófonos en Windows, consulte las notas del producto Compatibilidad de la matriz de micrófonos en Windows .

Requisitos

Requisito	Valor
Header	ksmedia.h (incluye Ksmedia.h)

Consulte también

KSAUDIO_MICROPHONE_COORDINATES