KSPROPERTY_AUDIO_VOLUMELEVEL

Artículo
06/15/2023

La propiedad KSPROPERTY_AUDIO_VOLUMELEVEL especifica el nivel de volumen de un canal en un nodo de volumen (KSNODETYPE_VOLUME).

Tabla de resumen de uso

Obtener	Set	Destino	Tipo de descriptor de propiedad	Tipo de valor de propiedad
Sí	Sí	Nodo a través de la instancia de Filtro o Anclar	KSNODEPROPERTY_AUDIO_CHANNEL	LONG

El valor de propiedad es de tipo LONG y especifica el nivel de volumen de un canal en una secuencia determinada. Los valores de nivel de volumen usan la siguiente escala:

-2147483648 es -infinity decibels (atenuación),

-2147483647 es -32767.99998474 decibelios (atenuación) y

+2147483647 es +32767.99998474 decibels (ganancia).

Nota:

El intervalo decibel se representa mediante valores enteros de -2147483648 a +2147483647, donde esta escala tiene una resolución de 1/65536 decibel.

Si se especifica un valor más allá del intervalo del filtro, la solicitud para establecer esta propiedad seguirá siendo correcta. Pero el valor real que se aplicó al filtro solo se puede determinar mediante una llamada Get posterior a esta propiedad.

Valor devuelto

Una solicitud de propiedad KSPROPERTY_AUDIO_VOLUMELEVEL 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

El descriptor de propiedad de esta propiedad especifica un número de canal. Si la secuencia que pasa por el nodo de volumen contiene n canales, los canales se numeran de 0 a n-1. Para obtener más información, consulte Exposición de nodos multicanal.