Método IAudioSessionControl2::SetDuckingPreference (audiopolicy.h)
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 |
|---|---|
|
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 |