IAudioSessionControl2：：SetDuckingPreference 方法 (audiopolicy.h)

SetDuckingPreference 方法可啟用或停用系統提供的預設串流衰減體驗 (自動減少) 。

語法

HRESULT SetDuckingPreference(
  [in] BOOL optOut
);

[in] optOut

BOOL 變數，可啟用或停用系統自動擷取。

如果方法成功，它會傳回 S_OK。如果失敗，可能的傳回碼包括，但不限於下表所示的值。

傳回值	描述
AUDCLNT_E_DEVICE_INVALIDATED	音訊會話會在預設音訊裝置上中斷連線。

根據預設，當系統啟動通訊會話，並在預設通訊裝置上接收新的通訊數據流時，系統會調整目前播放音效的所有音量。如需此功能的詳細資訊，請參閱使用通訊裝置。

如果應用程式在 optOut 中傳遞 TRUE，系統就會停用預設的小管體驗。如需詳細資訊，請參閱停用預設的擷取體驗。

若要提供自定義實作，應用程式必須在開啟或關閉通訊數據流時，從系統取得通知。若要接收通知，應用程式必須先呼叫此方法，再呼叫 IAudioSessionManager2：：RegisterForDuckNotification 自行註冊。如需詳細資訊和範例程式代碼，請參閱取得擷取事件。

如果應用程式在 optOut 中傳遞 FALSE，應用程式會提供系統所提供的預設數據流衰減體驗。

我們建議應用程式在串流建立期間呼叫 SetDuckingPreference 。不過，這個方法可以在會話期間動態呼叫，以變更初始喜好設定。