IAudioMeterInformation 인터페이스(endpointvolume.h)

IAudioMeterInformation 인터페이스는 오디오 엔드포인트 디바이스를 오가는 오디오 스트림의 최대 측정기를 나타냅니다. 클라이언트는 매개 변수 iid가 REFIID IID_IAudioMeterInformation 설정된 IMMDevice::Activate 메서드를 호출하여 엔드포인트 개체의 IAudioMeterInformation 인터페이스에 대한 참조를 가져옵니다.

엔드포인트 디바이스에서 오디오 데이터를 스트리밍하는 어댑터 디바이스가 하드웨어 피크 미터를 구현하는 경우 IAudioMeterInformation 인터페이스는 해당 미터를 사용하여 오디오 스트림의 최고 수준을 모니터링합니다. 오디오 디바이스에 하드웨어 최대 측정기가 없는 경우 오디오 엔진은 소프트웨어에서 피크 미터를 클라이언트에 투명하게 자동으로 구현합니다.

디바이스에 하드웨어 최대 측정기가 있는 경우 클라이언트는 IAudioMeterInformation 인터페이스의 메서드를 사용하여 공유 모드와 배타적 모드 모두에서 디바이스의 최고 수준을 모니터링할 수 있습니다. 디바이스에 하드웨어 최대 측정기가 없는 경우 클라이언트는 이러한 메서드를 사용하여 공유 모드에서 디바이스의 최고 수준을 모니터링할 수 있지만 배타적 모드에서는 모니터링할 수 없습니다. 전용 모드에서 클라이언트와 디바이스는 오디오 데이터를 직접 교환하여 소프트웨어 최대 측정기를 우회합니다. 전용 모드에서 소프트웨어 피크 미터는 항상 최고값인 0.0을 보고합니다.

디바이스에 하드웨어 최대 측정기가 있는지 확인하려면 IAudioMeterInformation::QueryHardwareSupport 메서드를 호출합니다.

렌더링 엔드포인트 디바이스의 경우 IAudioMeterInformation 인터페이스는 스트림이 엔드포인트 볼륨 컨트롤에 의해 감쇠되기 전에 출력 스트림의 최고 수준을 모니터링합니다. 마찬가지로, 캡처 엔드포인트 디바이스의 경우 인터페이스는 엔드포인트 볼륨 컨트롤에 의해 스트림이 감쇠되기 전에 입력 스트림의 최고 수준을 모니터링합니다.

IAudioMeterInformation 인터페이스의 메서드에서 보고하는 최대값은 0.0에서 1.0까지의 범위로 정규화됩니다. 예를 들어 PCM 스트림에 16비트 샘플이 포함되어 있고 특정 계량 기간 동안의 최고 샘플 값이 –8914인 경우 최대 측정기에서 기록한 절대값은 8914이고 IAudioMeterInformation 인터페이스에서 보고한 정규화된 최대값은 8914/32768 = 0.272입니다.

IAudioMeterInformation 인터페이스를 사용하는 코드 예제는 최대 미터를 참조하세요.

상속

IAudioMeterInformation 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IAudioMeterInformation 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IAudioMeterInformation 인터페이스에는 이러한 메서드가 있습니다.

IAudioMeterInformation::GetChannelsPeakValues GetChannelsPeakValues 메서드는 오디오 스트림의 모든 채널에 대한 최대 샘플 값을 가져옵니다.
IAudioMeterInformation::GetMeteringChannelCount GetMeteringChannelCount 메서드는 최대 미터로 모니터링되는 오디오 스트림의 채널 수를 가져옵니다.
IAudioMeterInformation::GetPeakValue GetPeakValue 메서드는 오디오 스트림의 채널에 대한 최대 샘플 값을 가져옵니다.
IAudioMeterInformation::QueryHardwareSupport QueryHardwareSupport 메서드는 오디오 엔드포인트 디바이스에서 하드웨어 지원 기능을 쿼리합니다. (IAudioMeterInformation.QueryHardwareSupport)

요구 사항

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

추가 정보

핵심 오디오 인터페이스

EndpointVolume API

IMMDevice::Activate