Compartir a través de

Método IAudioSessionControl2::SetDuckingPreference (audiopolicy.h)

  • Artículo

El método SetDuckingPreference habilita o deshabilita la experiencia de atenuación de flujo predeterminada (pato automático) proporcionada por el sistema.

Sintaxis

HRESULT SetDuckingPreference(
  [in] BOOL optOut
);

Parámetros

[in] optOut

Variable BOOL que habilita o deshabilita el pato automático del sistema.

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.

Valor devuelto Descripción
AUDCLNT_E_DEVICE_INVALIDATED
 La sesión de audio se desconecta en el dispositivo de audio predeterminado.

Comentarios

De forma predeterminada, el sistema ajusta el volumen de todos los sonidos que se están reproduciendo actualmente cuando el sistema inicia una sesión de comunicación y recibe una nueva secuencia de comunicación en el dispositivo de comunicación predeterminado. Para obtener más información sobre esta característica, consulte Uso de un dispositivo de comunicación.

Si la aplicación pasa TRUE en optOut, el sistema deshabilita la experiencia de pato predeterminada. Para obtener más información, vea Deshabilitar la experiencia de pato predeterminada.

Para proporcionar una implementación personalizada, la aplicación debe obtener notificaciones del sistema cuando se abre o cierra el flujo de comunicación. Para recibir las notificaciones, la aplicación debe llamar a este método antes de registrarse llamando a IAudioSessionManager2::RegisterForDuckNotification. Para obtener más información y código de ejemplo, vea Getting Ducking Events.

Si la aplicación pasa FALSE en optOut, la aplicación proporciona la experiencia de atenuación de flujos predeterminada proporcionada por el sistema.

Se recomienda que la aplicación llame a SetDuckingPreference durante la creación de la secuencia. Sin embargo, se puede llamar a este método dinámicamente durante la sesión para cambiar la preferencia inicial.

Requisitos

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

Consulte también

IAudioSessionControl2