IAudioSessionEvents::OnDisplayNameChanged 메서드(audiopolicy.h)
OnDisplayNameChanged 메서드는 클라이언트에 세션의 표시 이름이 변경되었음을 알 수 있습니다.
구문
HRESULT OnDisplayNameChanged(
[in] LPCWSTR NewDisplayName,
[in] LPCGUID EventContext
);
매개 변수
[in] NewDisplayName
세션의 새 표시 이름입니다. 이 매개 변수는 새 표시 이름을 포함하는 null로 끝나는 와이드 문자열을 가리킵니다. 문자열은 호출 기간 동안 유효한 상태로 유지됩니다.
[in] EventContext
이벤트 컨텍스트 값입니다. 이는 호출자가 세션의 표시 이름을 변경한 호출에서 IAudioSessionControl::SetDisplayName 에 전달한 값과 동일합니다. 자세한 내용은 설명 부분을 참조하세요.
반환 값
메서드가 성공하면 S_OK가 반환되고, 그렇지 않으면 오류 코드가 반환됩니다.
설명
세션 관리자는 IAudioSessionControl::SetDisplayName 메서드에 대한 호출이 세션의 표시 이름을 변경할 때마다 이 메서드를 호출합니다. Sndvol 프로그램은 세션의 표시 이름을 사용하여 세션의 볼륨 슬라이더에 레이블을 지정합니다.
EventContext 매개 변수는 클라이언트가 시작한 표시 이름 변경 내용과 다른 클라이언트가 시작한 변경 사항을 구분하는 수단을 제공합니다. IAudioSessionControl::SetDisplayName 메서드를 호출할 때 클라이언트는 OnDisplayNameChanged 메서드의 구현에서 인식할 수 있는 EventContext 매개 변수 값을 전달합니다.
IAudioSessionEvents 인터페이스에서 메서드를 구현하는 코드 예제는 오디오 세션 이벤트를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | audiopolicy.h |