Partilhar via


KSPROPERTY_AEC_MODE

A propriedade KSPROPERTY_AEC_MODE é usada para controlar o modo de operação de um nó AEC. Essa é uma propriedade opcional de um nó AEC (KSNODETYPE_ACOUSTIC_ECHO_CANCEL).

Tabela de Resumo de Uso

Obter Definir Destino Tipo de descritor de propriedade Tipo de valor da propriedade

Sim

Sim

Pin

KSNODEPROPERTY

ULONG

O valor da propriedade (dados de operação) é do tipo ULONG e pode ser definido como uma das seguintes constantes de modo do arquivo de cabeçalho Ksmedia.h:

  • AEC_MODE_PASS_THROUGH

    No modo de passagem, o nó AEC permite que os dados de captura e renderização simplesmente passem pelo nó sem serem modificados.

  • AEC_MODE_HALF_DUPLEX

    O algoritmo AEC está em execução no modo meio duplex, que é semelhante em operação a um telefone alto-falante. Nesse modo, o volume do alto-falante é silenciado sempre que a fala da pessoa local tem um nível de volume maior do que o da pessoa remota.

  • AEC_MODE_FULL_DUPLEX

    O algoritmo AEC está em execução no modo full-duplex.

O modo de passagem é o padrão. Quando o filtro que contém o nó AEC é criado ou o nó é redefinido, o nó é configurado inicialmente para operar no modo de passagem.

Na versão inicial do Windows XP, o algoritmo AEC que o filtro do sistema AEC usa não dá suporte ao modo meio duplex.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_AEC_MODE retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.

Requisitos

parâmetro

Ksmedia.h (inclua Ksmedia.h)

Confira também

KSNODEPROPERTY

KSNODETYPE_ACOUSTIC_ECHO_CANCEL