IAudioEndpointVolumeCallback::OnNotify 메서드(endpointvolume.h)
OnNotify 메서드는 오디오 엔드포인트 디바이스의 볼륨 수준 또는 음소거 상태가 변경되었음을 클라이언트에 알 수 있습니다.
구문
HRESULT OnNotify(
[in] PAUDIO_VOLUME_NOTIFICATION_DATA pNotify
);
매개 변수
[in] pNotify
볼륨 알림 데이터에 대한 포인터입니다. 이 매개 변수는 AUDIO_VOLUME_NOTIFICATION_DATA 형식의 구조를 가리킵니다.
반환 값
메서드가 성공하면 S_OK가 반환되고, 그렇지 않으면 오류 코드가 반환됩니다.
설명
pNotify 매개 변수는 OnNotify 호출을 시작한 볼륨 변경 이벤트를 설명하는 구조를 가리킵니다. 이 구조체에는 이벤트 컨텍스트 GUID가 포함되어 있습니다. 이 GUID를 사용하면 클라이언트가 시작한 볼륨(또는 음소거) 변경 내용과 다른 클라이언트가 시작한 변경 사항을 구분할 수 있습니다. 스트림의 볼륨 수준을 변경하는 IAudioEndpointVolume 메서드를 호출할 때 클라이언트는 OnNotify 메서드의 구현이 인식할 수 있는 이벤트 컨텍스트 GUID에 대한 포인터를 전달합니다. pNotify에서 가리키는 구조체에는 이 컨텍스트 GUID가 포함됩니다. 볼륨 수준을 변경하는 클라이언트가 이벤트 컨텍스트 GUID에 대한 포인터에 대한 NULL 포인터 값을 제공하는 경우 pNotify 가 가리키는 구조의 이벤트 컨텍스트 GUID 값은 GUID_NULL.
시스템의 볼륨 사용자 인터페이스인 Windows 7은 시스템의 볼륨을 변경할 때 GUID_NULL 지정하지 않습니다. 타사 OSD 애플리케이션은 시스템의 볼륨 사용자 인터페이스에서 발생하는 master 볼륨 제어 변경 내용과 기본 제공 볼륨 제어 처리기의 변경 내용과 같은 기타 볼륨 변경을 구분할 수 있습니다.
OnNotify 메서드를 구현하는 코드 예제는 엔드포인트 볼륨 컨트롤을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | endpointvolume.h |