KSPROPERTY_TOPOLOGYNODE_ENABLE

Artigo
06/14/2023

A propriedade KSPROPERTY_TOPOLOGYNODE_ENABLE é usada para ativar ou desativar os nós de topologia em uma topologia já criada.

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Sim	Filtrar	KSNODEPROPERTY	BOOL

O valor da propriedade (dados de operação) é do tipo BOOL e especifica se o nó está ativado ou desativado. Um valor true indica que o nó está ativado. FALSE indica que o nó está desativado.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_TOPOLOGYNODE_ENABLE 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

Habilitar um nó já habilitado ou desabilitar um nó já desabilitado não tem efeito, mas não deve ser tratado como um erro.

Desabilitar um nó desativa a transformação que o nó executa no fluxo que passa pelo nó. No caso de um nó AEC, AGC ou supressão de ruído (KSNODETYPE_ACOUSTIC_ECHO_CANCEL, KSNODETYPE_AGC ou KSNODETYPE_NOISE_SUPPRESS), por exemplo, um nó desabilitado opera no modo de passagem (ou seja, ele não executa nenhuma operação no fluxo à medida que flui do pino de entrada do nó para seu pino de saída).