KSPROPERTY_AUDIOENGINE_VOLUMELEVEL

Artículo
06/15/2023

La propiedad KSPROPERTY_AUDIOENGINE_VOLUMELEVEL especifica el nivel de volumen de un canal en una secuencia determinada.

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 Pin	KSNODEPROPERTY_AUDIO_CHANNEL	LONG (para una solicitud Get) y KSAUDIOENGINE_VOLUMELEVEL (para una solicitud Set).

Para una solicitud Get, el valor de la 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 escala siguiente y se pueden enlazar por los valores mínimo y máximo proporcionados en la respuesta de soporte técnico básico para esta propiedad:

-2147483648 (0x80000000 en hexadecimal o LONG_MIN) es -Infinity decibels (atenuación),

-2147483647 (0x80000001 en hexadecimal o LONG_MIN + 1) es -32767.99998474 decibelios (atenuación) y

+2147483647 (0x7FFFFFFF en hexadecimal o LONG_MAX) es +32767.999998474 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.

Para una solicitud Set, el valor de la propiedad es de tipo KSAUDIOENGINE_VOLUMELEVEL y especifica el nivel de volumen deseado de un canal en una secuencia determinada, así como un tipo de curva y una duración de curva que se aplicarán a medida que se establece el nivel de volumen. 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

La solicitud de propiedad KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS 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 para KSPROPERTY_AUDIOENGINE_VOLUMELEVEL especifica un número de canal. Si la secuencia que pasa por el nodo del motor de audio contiene n canales, los canales se numeran de 0 a n-1. Tenga en cuenta también que un valor de canal de 0xFFFFFFFF indica que la solicitud se aplica a todos los canales. Si se realiza una solicitud de propiedad mientras la secuencia no está en estado en ejecución, el nivel de volumen se establece inmediatamente en el nivel solicitado. Si la secuencia deja el estado de ejecución mientras una rampa de nivel de volumen está en curso, el nivel de volumen de la secuencia se establece inmediatamente en el nivel de destino del fundido actual. Si se realiza una nueva solicitud de propiedad mientras una rampa de nivel de volumen existente está en curso, la nueva solicitud de rampa debe comenzar desde el nivel de volumen actual, el nivel que el volumen había alcanzado cuando llegó la nueva solicitud.