estrutura KSAUDIO_MIC_ARRAY_GEOMETRY (ksmedia.h)
A estrutura KSAUDIO_MIC_ARRAY_GEOMETRY especifica o tipo e a geometria da matriz de microfone. O membro usNumberOfMicrophones indica o número de microfones na matriz física. O membro KsMicCoord é uma variável do tipo KSAUDIO_MICROPHONE_COORDINATES e é uma matriz de estruturas. O número de entradas nessa matriz é fornecido pelo valor do membro usNumberOfMicrophones .
Sintaxe
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;
Membros
usVersion
Especifica o número de versão da estrutura KSAUDIO_MIC_ARRAY_GEOMETRY. Esse membro é um valor BCD e está atualmente definido como 0x0100, que representa um número de versão 1.0.
usMicArrayType
Especifica o tipo de matriz de microfone em uso. Esse membro pode ser qualquer um dos valores de enumeração KSMICARRAY_MICARRAYTYPE mostrados na tabela a seguir.
| Valor | Tipo de matriz de microfone |
|---|---|
| KSMICARRAY_MICARRAYTYPE_LINEAR | Linear |
| KSMICARRAY_MICARRAYTYPE_PLANAR | Planar |
| KSMICARRAY_MICARRAYTYPE_3D | 3D |
wVerticalAngleBegin
Especifica o ângulo vertical do início do volume de trabalho da matriz de microfone.
wVerticalAngleEnd
Especifica o ângulo vertical do final do volume de trabalho da matriz de microfone.
wHorizontalAngleBegin
Início do Volume de Trabalho HorizontalAngle
wHorizontalAngleEnd
Volume de Trabalho HorizontalAngle End
usFrequencyBandLo
Especifica a extremidade baixa do intervalo de frequência para a matriz de microfone.
usFrequencyBandHi
Especifica a extremidade alta do intervalo de frequência para a matriz de microfone.
usNumberOfMicrophones
Especifica o número de microfones na matriz de microfone.
KsMicCoord[1]
Especifica a matriz de estruturas de KSAUDIO_MICROPHONE_COORDINATES que contém os locais dos microfones na matriz.
Comentários
Todos os valores angulares são expressos em unidades de 1/10000 de um radian. Por exemplo, 3.1416 radianos são expressos como 31416 unidades. Os valores aceitáveis variam de -31416 a 31416 unidades.
Todos os valores de coordenada são expressos em milímetros. Os valores aceitáveis variam de -32768 a 32767, inclusive.
Os valores de frequência são expressos em Hertz (Hz).
Para obter mais informações sobre como processar uma matriz de microfone no Windows, consulte o suporte à matriz de microfone no white paper do Windows.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ksmedia.h (inclua Ksmedia.h) |