Metodo IAudioSessionControl2::SetDuckingPreference (audiopolicy.h)

Il metodo SetDuckingPreference abilita o disabilita l'esperienza di attenuazione del flusso predefinita (anatratura automatica) fornita dal sistema.

Sintassi

HRESULT SetDuckingPreference(
  [in] BOOL optOut
);

Parametri

[in] optOut

Variabile BOOL che abilita o disabilita l'anatratura automatica del sistema.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Valore restituito Descrizione
AUDCLNT_E_DEVICE_INVALIDATED
La sessione audio viene disconnessa nel dispositivo audio predefinito.

Commenti

Per impostazione predefinita, il sistema regola il volume per tutti i suoni attualmente riprodotti quando il sistema avvia una sessione di comunicazione e riceve un nuovo flusso di comunicazione nel dispositivo di comunicazione predefinito. Per altre informazioni su questa funzionalità, vedere Uso di un dispositivo di comunicazione.

Se l'applicazione passa TRUE in optOut, il sistema disabilita l'esperienza di anatratura predefinita. Per altre informazioni, vedere Disabilitazione dell'esperienza di anatratura predefinita.

Per fornire un'implementazione personalizzata, l'applicazione deve ricevere notifiche dal sistema quando si apre o chiude il flusso di comunicazione. Per ricevere le notifiche, l'applicazione deve chiamare questo metodo prima di registrarsi chiamando IAudioSessionManager2::RegisterForDuckNotification. Per altre informazioni e codice di esempio, vedere Recupero di eventi di anatratura.

Se l'applicazione passa FALSE in optOut, l'applicazione fornisce l'esperienza di attenuazione del flusso predefinita fornita dal sistema.

È consigliabile chiamare l'applicazione SetDuckingPreference durante la creazione del flusso. Tuttavia, questo metodo può essere chiamato dinamicamente durante la sessione per modificare la preferenza iniziale.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione audiopolicy.h

Vedi anche

IAudioSessionControl2