Compartilhar via


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
AUDCLNT_E_DEVICE_INVALIDATED
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

Confira também

IAudioSessionControl2