KSPROPERTY_TOPOLOGYNODE_ENABLE

Artículo
06/14/2023

La propiedad KSPROPERTY_TOPOLOGYNODE_ENABLE se usa para activar o desactivar los nodos de topología en una topología ya creada.

Tabla de resumen de uso

Obtener	Set	Destino	Tipo de descriptor de propiedad	Tipo de valor de propiedad
Sí	Sí	Filtrar	KSNODEPROPERTY	BOOL

El valor de propiedad (datos de operación) es de tipo BOOL y especifica si el nodo está activado o desactivado. Un valor true indica que el nodo está activado. FALSE indica que el nodo está desactivado.

Valor devuelto

Una solicitud de propiedad KSPROPERTY_TOPOLOGYNODE_ENABLE devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de estado de error adecuado.

Observaciones

La habilitación de un nodo ya habilitado o la deshabilitación de un nodo ya deshabilitado no tiene ningún efecto, pero no debe tratarse como un error.

Al deshabilitar un nodo, se desactiva la transformación que realiza el nodo en la secuencia que pasa por el nodo. En el caso de un nodo AEC, AGC o supresión de ruido (KSNODETYPE_ACOUSTIC_ECHO_CANCEL, KSNODETYPE_AGC o KSNODETYPE_NOISE_SUPPRESS), por ejemplo, un nodo deshabilitado funciona en modo de paso a través (es decir, no realiza ninguna operación en la secuencia a medida que fluye desde el pin de entrada del nodo a su pin de salida).