KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY

Artigo
06/14/2023

A propriedade KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY especifica a geometria da matriz de microfone.

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Não	Filtrar	KSP_PIN	KSAUDIO_MIC_ARRAY_GEOMETRY

O valor da propriedade (dados da operação) é do tipo KSAUDIO_MIC_ARRAY_GEOMETRY. Consulte a definição da estrutura KSAUDIO_MIC_ARRAY_GEOMETRY para obter detalhes.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY retorna um STATUS_SUCCESS após a conclusão bem-sucedida da solicitação.

Se o pino indicado pelo membro PinId da estrutura KSP_PIN não der suporte a uma solicitação de matriz de microfone, a solicitação de propriedade retornará STATUS_NOT_SUPPORTED.

Se o tamanho do buffer da solicitação for definido como zero, a solicitação de propriedade retornará um STATUS_BUFFER_OVERFLOW status. Além disso, a solicitação usará o bloco de retorno status para indicar o tamanho da estrutura de KSAUDIO_MIC_ARRAY_GEOMETRY compatível com o pino.

Se o tamanho do buffer da solicitação for definido como qualquer tamanho de buffer muito pequeno para acomodar a estrutura retornada, a solicitação retornará uma status de STATUS_BUFFER_TOO_SMALL. Em seguida, a solicitação usará o bloco de status de retorno para indicar o tamanho da estrutura KSAUDIO_MIC_ARRAY_GEOMETRY compatível com o pino.

Comentários

A propriedade KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY dá suporte apenas a solicitações de KSPROPERTY_TYPE_GET. Para que o cliente determine o tamanho correto do buffer necessário para acomodar toda a estrutura de geometria, ele deve primeiro fazer a solicitação com um tamanho de buffer zero. Em seguida, o cliente pode usar o valor retornado no bloco status para definir o tamanho do buffer corretamente e, em seguida, fazer outra solicitação de propriedade com o buffer de tamanho correto.

Para obter mais informações sobre como processar uma matriz de microfone no Windows, consulte os seguintes recursos:

Propriedade Geometry da Matriz de Microfone

Suporte à matriz de microfone no Windows (white paper)