KSPROPERTY_AUDIO_ALGORITHM_INSTANCE
A propriedade KSPROPERTY_AUDIO_ALGORITHM_INSTANCE especifica o algoritmo DSP (processamento de sinal digital) usado para obter o efeito de terceiros que o nó aplica ao fluxo de dados de áudio. Os efeitos definidos para essa propriedade incluem cancelamento de eco acústico e supressão de ruído.
Tabela de Resumo de Uso
| Obter | Definir | Destino | Tipo de descritor de propriedade | Tipo de valor da propriedade |
|---|---|---|---|---|
Sim |
Sim |
Filtrar |
GUID |
O valor da propriedade (dados de operação) é um GUID que identifica o efeito que o pino aplica ao fluxo de dados. Esse valor pode ser um dos seguintes GUIDs do arquivo de cabeçalho Ksmedia.h:
KSALGORITHMINSTANCE_SYSTEM_AGC
Reservado para uso futuro
KSALGORITHMINSTANCE_SYSTEM_ACOUSTIC_ECHO_CANCEL
Algoritmo de cancelamento de eco acústico padrão do sistema
KSALGORITHMINSTANCE_SYSTEM_MICROPHONE_ARRAY_PROCESSOR
Reservado para uso futuro
KSALGORITHMINSTANCE_SYSTEM_NOISE_SUPPRESS
Algoritmo de supressão de ruído padrão do sistema
Valor retornado
Uma solicitação de propriedade KSPROPERTY_AUDIO_ALGORITHM_INSTANCE retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.
Comentários
Essa propriedade é usada para controlar o algoritmo DSP executado por um nó AEC (KSNODETYPE_ACOUSTIC_ECHO_CANCEL) ou nó de supressão de ruído (KSNODETYPE_NOISE_SUPPRESS).
O GUID da instância de algoritmo corresponde ao valor no membro guidDSCFXInstance de uma estrutura DSCEFFECTDESC que um chamador passa para o método IDirectSoundCapture::CreateCaptureBuffer ou a função DirectSoundFullDuplexCreate . Para obter mais informações, consulte a documentação do SDK do Microsoft Windows.
Requisitos
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |