IAudioSessionEvents::OnGroupingParamChanged 메서드(audiopolicy.h)

OnGroupingParamChanged 메서드는 세션의 그룹화 매개 변수가 변경되었음을 클라이언트에 알 수 있습니다.

구문

HRESULT OnGroupingParamChanged(
  [in] LPCGUID NewGroupingParam,
  [in] LPCGUID EventContext
);

매개 변수

[in] NewGroupingParam

세션에 대한 새 그룹화 매개 변수입니다. 이 매개 변수는 grouping-parameter GUID를 가리킵니다.

[in] EventContext

이벤트 컨텍스트 값입니다. 이는 호출자가 세션의 그룹화 매개 변수를 변경한 호출에서 IAudioSessionControl::SetGroupingParam 에 전달한 값과 동일합니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

메서드가 성공하면 S_OK가 반환되고, 그렇지 않으면 오류 코드가 반환됩니다.

설명

세션 관리자는 IAudioSessionControl::SetGroupingParam 메서드에 대한 호출이 세션의 그룹화 매개 변수를 변경할 때마다 이 메서드를 호출합니다.

EventContext 매개 변수는 클라이언트가 시작한 grouping-parameter 변경 내용과 다른 클라이언트가 시작한 변경 사항을 구분하는 수단을 제공합니다. IAudioSessionControl::SetGroupingParam 메서드를 호출할 때 클라이언트는 OnGroupingParamChanged 메서드의 구현에서 인식할 수 있는 EventContext 매개 변수 값을 전달합니다.

IAudioSessionEvents 인터페이스에서 메서드를 구현하는 코드 예제는 오디오 세션 이벤트를 참조하세요.

요구 사항

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

추가 정보

IAudioSessionControl::SetGroupingParam

IAudioSessionEvents 인터페이스