IAudioSessionControl2::SetDuckingPreference-Methode (audiopolicy.h)

Die SetDuckingPreference-Methode aktiviert oder deaktiviert die standardmäßige Streamdämpfungserfahrung (auto-ducking), die vom System bereitgestellt wird.

Syntax

HRESULT SetDuckingPreference(
  [in] BOOL optOut
);

Parameter

[in] optOut

Eine BOOL-Variable , die das automatische Enten des Systems aktiviert oder deaktiviert.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabewert	BESCHREIBUNG
AUDCLNT_E_DEVICE_INVALIDATED	Die Audiositzung wird auf dem Standardaudiogerät getrennt.

Hinweise

Standardmäßig passt das System die Lautstärke für alle derzeit wiedergegebenen Sounds an, wenn das System eine Kommunikationssitzung startet und einen neuen Kommunikationsdatenstrom auf dem Standardkommunikationsgerät empfängt. Weitere Informationen zu diesem Feature finden Sie unter Verwenden eines Kommunikationsgeräts.

Wenn die Anwendung true in optOut übergibt, deaktiviert das System die Standard-Ducking-Erfahrung. Weitere Informationen finden Sie unter Deaktivieren der Standard-Ducking-Erfahrung.

Um eine benutzerdefinierte Implementierung bereitzustellen, muss die Anwendung Benachrichtigungen vom System erhalten, wenn sie den Kommunikationsdatenstrom öffnet oder schließt. Um die Benachrichtigungen zu erhalten, muss die Anwendung diese Methode aufrufen, bevor sie sich selbst registriert, indem IAudioSessionManager2::RegisterForDuckNotification aufgerufen wird. Weitere Informationen und Beispielcode finden Sie unter Getting Ducking Events.For more information and example code, see Getting Ducking Events.

Wenn die Anwendung false in optOut übergibt, stellt die Anwendung die standardmäßige Streamdämpfung bereit, die vom System bereitgestellt wird.

Es wird empfohlen, dass die Anwendung SetDuckingPreference während der Streamerstellung aufruft. Diese Methode kann jedoch während der Sitzung dynamisch aufgerufen werden, um die anfängliche Einstellung zu ändern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	audiopolicy.h

Weitere Informationen

IAudioSessionControl2