KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY
A propriedade KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY especifica a geometria da matriz de microfone.
Tabela de Resumo de Uso
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)
Requisitos
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |