Propriedade Geometry da Matriz de Microfone
No Windows Vista e posterior, o suporte é fornecido para matrizes de microfone. Na maioria das situações, um único microfone inserido em um laptop ou monitor não captura muito bem o som. Uma matriz de microfones tem um desempenho melhor para isolar uma fonte de som e rejeitar ruído ambiente e reverberação. A propriedade KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY especifica a geometria de uma matriz de microfone. O valor da propriedade, KSAUDIO_MIC_ARRAY_GEOMETRY, descreve o tipo de matriz (linear, planar e assim por diante), o número de microfones na matriz e outros recursos.
Este tópico descreve como matrizes de microfone USB externas podem usar o suporte à matriz de microfone fornecido com o Windows Vista. Uma matriz de microfone USB externa deve fornecer os parâmetros necessários para descrever a geometria e outros recursos de sua matriz em resposta a uma solicitação de GET_MEM .
A matriz de microfone USB usa um formato padrão para fornecer as informações de geometria. O driver de classe de áudio USB do Windows Vista deve usar o mesmo formato ao ler as informações de geometria. Para obter mais informações sobre o formato padrão, consulte Formato do descritor geometry da matriz de microfone.
Um aplicativo pode chamar IPart::GetSubType para recuperar informações sobre uma tomada para determinar se o dispositivo conectado à tomada é uma matriz de microfone. IPart::GetSubType retorna um GUID de categoria de pino que representa o tipo de entrada. Se o dispositivo conectado for uma matriz de microfone, o GUID retornado será igual a KSNODETYPE_MICROPHONE_ARRAY. O aplicativo também pode ajudá-lo a determinar se você conectou a matriz de microfone à tomada errada. No último cenário, o GUID de categoria de pino retornado é para um dispositivo diferente ou indica que não há nenhum dispositivo conectado à tomada do microfone. Para obter mais informações sobre os GUIDs da categoria de pino, consulte Propriedade Categoria de Pino.
Depois que um aplicativo descobre uma matriz de microfone conectada à tomada de entrada correta, a próxima etapa é determinar a geometria da matriz. Há três geometrias básicas: linear, planar e tridimensional (3D). As informações de geometria também fornecem detalhes, como o intervalo de frequência e as coordenadas x-y-z de cada microfone.
O exemplo de código a seguir mostra uma estrutura KSAUDIO_MIC_ARRAY_GEOMETRY que um driver de áudio usa para descrever uma matriz de microfone USB externa:
KSAUDIO_MIC_ARRAY_GEOMETRY mic_Array =
{
0x100,// usVersion (1.0)
KSMICARRAY_MICARRAYTYPE_LINEAR,// usMicArrayType
7854, // wVerticalAngleBegin (45 deg; PI/4 radians x 10000)
-7854, // wVerticalAngleEnd
0, // lHorizontalAngleBegin
0, // lHorizontalAngleEnd
25, // usFrequencyBandLo in Hz
19500, // usFrequencyBandHi in Hz
2, // usNumberOfMicrophones
ar_mic_Coordinates // KsMicCoord
};
No exemplo de código anterior, a variável ar_mic_Coordinates é uma matriz da estrutura KSAUDIO_MICROPHONE_COORDINATES e contém as coordenadas para os microfones na matriz de microfone.
O exemplo de código a seguir mostra como a matriz ar_mic_Coordinates é usada para descrever os locais geométricos dos microfones na matriz de microfone, conforme descrito no exemplo de código anterior:
KsMicCoord ar_mic_Coordinates[] =
{
// Array microphone 1
{
KSMICARRAY_MICTYPE_CARDIOID,// usType
100, // wXCoord (mic elements are 200 mm apart)
0,// wYCoord
0, // wZCoord
0,// wVerticalAngle
0,// wHorizontalAngle
},
// Array microphone 2
{
KSMICARRAY_MICTYPE_CARDIOID,// usType
-100, // wXCoord
0,// wYCoord
0, // wZCoord
0,// wVerticalAngle
0,// wHorizontalAngle
}
};
No exemplo de código anterior, as coordenadas x-y-z são fornecidas para cada microfone na matriz de microfone, juntamente com os ângulos vertical e horizontal que descrevem suas áreas de trabalho efetivas.
Para modificar o driver de exemplo msvad micarray para fornecer informações de geometria de matriz para uma matriz de microfone virtual, você deve executar as tarefas a seguir.
Primeiro, navegue até Src\Audio\Msvad\Micarray e localize o arquivo Mintopo.cpp. Edite a seção do manipulador de propriedades em Mintopo.cpp para que a estrutura KSAUDIO_MIC_ARRAY_GEOMETRY contenha informações sobre a matriz de microfone. A seção específica do código que você deve modificar é mostrada no exemplo de código a seguir:
// Modify this portion of PropertyHandlerMicArrayGeometry
PKSAUDIO_MIC_ARRAY_GEOMETRY pMAG = (PKSAUDIO_MIC_ARRAY_GEOMETRY)PropertyRequest->Value;
// fill in mic array geometry fields
pMAG->usVersion = 0x0100; // Version of Mic array specification (0x0100)
pMAG->usMicArrayType = (USHORT)KSMICARRAY_MICARRAYTYPE_LINEAR; // Type of Mic Array
pMAG->wVerticalAngleBegin = -7854; // Work Volume Vertical Angle Begin (-45 degrees)
pMAG->wVerticalAngleEnd = 7854; // Work Volume Vertical Angle End (+45 degrees)
pMAG->wHorizontalAngleBegin = 0; // Work Volume Horizontal Angle Begin
pMAG->wHorizontalAngleEnd = 0; // Work Volume Horizontal Angle End
pMAG->usFrequencyBandLo = 100; // Low end of Freq Range
pMAG->usFrequencyBandHi = 8000; // High end of Freq Range
pMAG->usNumberOfMicrophones = 2; // Count of microphone coordinate structures to follow.
pMAG->KsMicCoord[0].usType = (USHORT)KSMICARRAY_MICTYPE_CARDIOID;
pMAG->KsMicCoord[0].wXCoord = -100; // mic elements are 200 mm apart
pMAG->KsMicCoord[0].wYCoord = 0;
pMAG->KsMicCoord[0].wZCoord = 0;
pMAG->KsMicCoord[0].wVerticalAngle = 0;
pMAG->KsMicCoord[0].wHorizontalAngle = 0;
pMAG->KsMicCoord[1].usType = (USHORT)KSMICARRAY_MICTYPE_CARDIOID;
pMAG->KsMicCoord[1].wXCoord = 100; // mic elements are 200 mm apart
pMAG->KsMicCoord[1].wYCoord = 0;
pMAG->KsMicCoord[1].wZCoord = 0;
pMAG->KsMicCoord[1].wVerticalAngle = 0;
pMAG->KsMicCoord[1].wHorizontalAngle = 0;
O exemplo de código anterior mostra informações fornecidas para uma matriz de microfone linear que tem dois elementos de microfone, cada um deles um tipo cardioide e localizado a 100 mm do centro da matriz.
Para obter informações sobre como desenvolver um aplicativo para descobrir matrizes de microfone, consulte Apêndice C de Como criar e usar matrizes de microfone para Windows Vista.