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

El método SetLevelUniform establece todos los canales de la secuencia de audio en el mismo nivel uniforme de volumen, en decibelios.

Sintaxis

HRESULT SetLevelUniform(
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

Parámetros

[in] fLevelDB

Nuevo nivel uniforme en decibelios.

[in] pguidEventContext

Valor de contexto del método IControlChangeNotify::OnNotify . Este parámetro apunta a un GUID de contexto de evento. Si la llamada a SetLevelUniform cambia el estado del control de nivel, todos los clientes que han registrado interfaces IControlChangeNotify con ese control reciben notificaciones. En su implementación del método OnNotify , un cliente puede inspeccionar el GUID del contexto de eventos para detectar si él u otro cliente es el origen del evento de cambio de control. Si el autor de la llamada proporciona un puntero NULL para este parámetro, el método de notificación del cliente recibe un puntero de contexto NULL .

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto	Descripción
E_OUTOFMEMORY	Memoria insuficiente

Comentarios

Si el nivel uniforme especificado está fuera del intervalo que informa el método IPerChannelDbLevel::GetLevelRange para un canal determinado, la llamada SetLevelUniform sujeta el valor de ese canal al intervalo admitido y se completa correctamente. Una llamada posterior al método IPerChannelDbLevel::GetLevel recupera el valor real usado para ese canal.

Requisitos

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::GetLevel

IPerChannelDbLevel::GetLevelRange