Método IPerChannelDbLevel::GetLevelRange (devicetopology.h)

Artículo
03/05/2024

El método GetLevelRange obtiene el intervalo, en decibelios, del nivel de volumen del canal especificado.

Sintaxis

HRESULT GetLevelRange(
  [in]  UINT  nChannel,
  [out] float *pfMinLevelDB,
  [out] float *pfMaxLevelDB,
  [out] float *pfStepping
);

Parámetros

[in] nChannel

Número del canal seleccionado. Si la secuencia de audio tiene n canales, los canales se numeran de 0 a n– 1. Para obtener el número de canales de la secuencia, llame al método IPerChannelDbLevel::GetChannelCount .

[out] pfMinLevelDB

Puntero a una variable float en la que el método escribe el nivel de volumen mínimo en decibelios.

[out] pfMaxLevelDB

Puntero a una variable float en la que el método escribe el nivel máximo de volumen en decibelios.

[out] pfStepping

Puntero a una variable float en la que el método escribe el valor de ejecución paso a paso entre los niveles de volumen consecutivos del intervalo *pfMinLevelDB en *pfMaxLevelDB. Si la diferencia entre los niveles de volumen máximo y mínimo es d decibelios y el intervalo se divide en n pasos (intervalos de tamaño uniforme), el volumen puede tener n + 1 niveles discretos y el tamaño del paso entre niveles consecutivos es d / n decibelios.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto	Descripción
E_INVALIDARG	El parámetro nChannel está fuera del intervalo.
E_POINTER	El puntero pfminLevelDB, pfmaxLevelDB o pfmaxLevelDB es NULL.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	devicetopology.h

Consulte también

IPerChannelDbLevel (Interfaz)

IPerChannelDbLevel::GetChannelCount