Share via

IAudioSessionControl2::SetDuckingPreference 메서드(audiopolicy.h)

  • 아티클

SetDuckingPreference 메서드는 시스템에서 제공하는 기본 스트림 감쇠 환경(자동 더킹)을 사용하거나 사용하지 않도록 설정합니다.

구문

HRESULT SetDuckingPreference(
  [in] BOOL optOut
);

매개 변수

[in] optOut

시스템 자동 더킹을 사용하거나 사용하지 않도록 설정하는 BOOL 변수입니다.

반환 값

메서드가 성공하면 S_OK가 반환되고, 실패할 경우 가능한 반환 코드는 다음 표에 표시된 값을 포함하지만 이에 국한되지 않습니다.

반환 값 Description
AUDCLNT_E_DEVICE_INVALIDATED
 기본 오디오 디바이스에서 오디오 세션의 연결이 끊어졌습니다.

설명

기본적으로 시스템은 시스템이 통신 세션을 시작하고 기본 통신 디바이스에서 새 통신 스트림을 수신할 때 현재 재생 중인 모든 소리의 볼륨을 조정합니다. 이 기능에 대한 자세한 내용은 통신 디바이스 사용을 참조하세요.

애플리케이션이 optOut에서 TRUE를 통과하면 시스템은 기본 더킹 환경을 사용하지 않도록 설정합니다. 자세한 내용은 기본 더킹 환경 비활성화를 참조하세요.

사용자 지정 구현을 제공하려면 애플리케이션이 통신 스트림을 열거나 닫을 때 시스템에서 알림을 받아야 합니다. 알림을 받으려면 애플리케이션이 IAudioSessionManager2::RegisterForDuckNotification을 호출하여 등록하기 전에 이 메서드를 호출해야 합니다. 자세한 내용 및 예제 코드는 더킹 이벤트 가져오기를 참조하세요.

애플리케이션이 optOut에서 FALSE를 전달하는 경우 애플리케이션은 시스템에서 제공하는 기본 스트림 감쇠 환경을 제공합니다.

스트림을 만드는 동안 애플리케이션에서 SetDuckingPreference 를 호출하는 것이 좋습니다. 그러나 이 메서드는 세션 중에 동적으로 호출하여 초기 기본 설정을 변경할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 audiopolicy.h

추가 정보

IAudioSessionControl2