다음을 통해 공유

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

추가 정보

AUDIO_VOLUME_NOTIFICATION_DATA

IAudioEndpointVolume 인터페이스

IAudioEndpointVolumeCallback 인터페이스