Método IAudioSessionControl2::SetDuckingPreference (audiopolicy.h)
O método SetDuckingPreference habilita ou desabilita a experiência de atenuação de fluxo padrão (pato automático) fornecida pelo sistema.
Sintaxe
HRESULT SetDuckingPreference(
[in] BOOL optOut
);
Parâmetros
[in] optOut
Uma variável BOOL que habilita ou desabilita o ducking automático do sistema.
Retornar valor
Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.
| Valor retornado | Descrição |
|---|---|
|
A sessão de áudio é desconectada no dispositivo de áudio padrão. |
Comentários
Por padrão, o sistema ajusta o volume para todos os sons que estão sendo reproduzidos no momento quando o sistema inicia uma sessão de comunicação e recebe um novo fluxo de comunicação no dispositivo de comunicação padrão. Para obter mais informações sobre esse recurso, consulte Usando um dispositivo de comunicação.
Se o aplicativo passar TRUE em optOut, o sistema desabilita a Experiência de Ducking Padrão. Para obter mais informações, consulte Desabilitando a experiência de ducking padrão.
Para fornecer uma implementação personalizada, o aplicativo precisa receber notificações do sistema quando abre ou fecha o fluxo de comunicação. Para receber as notificações, o aplicativo deve chamar esse método antes de se registrar chamando IAudioSessionManager2::RegisterForDuckNotification. Para obter mais informações e código de exemplo, consulte Obtendo eventos de ducking.
Se o aplicativo passar FALSE em optOut, o aplicativo fornecerá a experiência de atenuação de fluxo padrão fornecida pelo sistema.
Recomendamos que o aplicativo chame SetDuckingPreference durante a criação do fluxo. No entanto, esse método pode ser chamado dinamicamente durante a sessão para alterar a preferência inicial.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | audiopolicy.h |