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

OnIconPathChanged 메서드는 세션의 표시 아이콘이 변경되었음을 클라이언트에 알 수 있습니다.

구문

HRESULT OnIconPathChanged(
  [in] LPCWSTR NewIconPath,
  [in] LPCGUID EventContext
);

매개 변수

[in] NewIconPath

세션에 대한 새 표시 아이콘의 경로입니다. 이 매개 변수는 새 아이콘의 경로가 포함된 문자열을 가리킵니다. 문자열 포인터는 호출 기간 동안만 유효합니다.

[in] EventContext

이벤트 컨텍스트 값입니다. 이는 호출자가 세션의 표시 아이콘을 변경한 호출에서 IAudioSessionControl::SetIconPath 에 전달한 값과 동일합니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

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

설명

세션 관리자는 IAudioSessionControl::SetIconPath 메서드를 호출할 때마다 이 메서드를 호출하여 세션의 표시 아이콘을 변경합니다. Sndvol 프로그램은 세션의 표시 아이콘을 사용하여 세션의 볼륨 슬라이더에 레이블을 지정합니다.

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

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

요구 사항

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

추가 정보

IAudioSessionControl::SetIconPath

IAudioSessionEvents 인터페이스