KSPROPERTY_AUDIO_ALGORITHM_INSTANCE

Artigo
06/14/2023

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	KSNODEPROPERTY	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.