Поделиться через

Метод IAudioSessionControl2::SetDuckingPreference (audiopolicy.h)

  • Статья

Метод SetDuckingPreference включает или отключает процесс затухания потока по умолчанию (автоматическое утихание), предоставляемый системой.

Синтаксис

HRESULT SetDuckingPreference(
  [in] BOOL optOut
);

Параметры

[in] optOut

Переменная BOOL , которая включает или отключает автоматическое удаление системы.

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.

Возвращаемое значение Описание
AUDCLNT_E_DEVICE_INVALIDATED
 Звуковой сеанс отключен на звуковом устройстве по умолчанию.

Комментарии

По умолчанию система настраивает громкость для всех текущих звуков, когда система запускает сеанс связи и получает новый поток связи на устройстве связи по умолчанию. Дополнительные сведения об этой функции см. в разделе Использование устройства связи.

Если приложение передает значение TRUE в параметре optOut, система отключает функцию Ducking по умолчанию. Дополнительные сведения см. в разделе Отключение интерфейса ducking по умолчанию.

Чтобы обеспечить пользовательскую реализацию, приложение должно получать уведомления от системы при открытии или закрытии потока связи. Чтобы получить уведомления, приложение должно вызвать этот метод перед регистрацией, вызвав IAudioSessionManager2::RegisterForDuckNotification. Дополнительные сведения и пример кода см. в разделе Получение событий ducking.

Если приложение передает значение FALSE в optOut, оно предоставляет интерфейс затухания потока по умолчанию, предоставляемый системой.

Рекомендуется, чтобы приложение вызывало SetDuckingPreference во время создания потока. Однако этот метод может вызываться динамически во время сеанса, чтобы изменить первоначальные предпочтения.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header audiopolicy.h

См. также раздел

IAudioSessionControl2