Antarmuka IAudioMeterInformation (endpointvolume.h)

Antarmuka IAudioMeterInformation mewakili meteran puncak pada aliran audio ke atau dari perangkat titik akhir audio. Klien mendapatkan referensi ke antarmuka IAudioMeterInformation pada objek titik akhir dengan memanggil metode IMMDevice::Activate dengan parameter iid diatur ke REFIID IID_IAudioMeterInformation.

Jika perangkat adaptor yang mengalirkan data audio ke atau dari perangkat titik akhir mengimplementasikan pengukur puncak perangkat keras, antarmuka IAudioMeterInformation menggunakan meteran tersebut untuk memantau tingkat puncak di aliran audio. Jika perangkat audio tidak memiliki pengukur puncak perangkat keras, mesin audio secara otomatis mengimplementasikan pengukur puncak dalam perangkat lunak, secara transparan kepada klien.

Jika perangkat memiliki pengukur puncak perangkat keras, klien dapat menggunakan metode di antarmuka IAudioMeterInformation untuk memantau tingkat puncak perangkat dalam mode bersama dan mode eksklusif. Jika perangkat tidak memiliki pengukur puncak perangkat keras, klien dapat menggunakan metode tersebut untuk memantau tingkat puncak perangkat dalam mode bersama, tetapi tidak dalam mode eksklusif. Dalam mode eksklusif, klien dan perangkat bertukar data audio secara langsung, melewati pengukur puncak perangkat lunak. Dalam mode eksklusif, pengukur puncak perangkat lunak selalu melaporkan nilai puncak 0,0.

Untuk menentukan apakah perangkat memiliki pengukur puncak perangkat keras, panggil metode IAudioMeterInformation::QueryHardwareSupport .

Untuk perangkat titik akhir penyajian, antarmuka IAudioMeterInformation memantau tingkat puncak dalam aliran output sebelum aliran dilemahkan oleh kontrol volume titik akhir. Demikian pula, untuk perangkat titik akhir pengambilan, antarmuka memantau tingkat puncak dalam aliran input sebelum aliran dilemahkan oleh kontrol volume titik akhir.

Nilai puncak yang dilaporkan oleh metode dalam antarmuka IAudioMeterInformation dinormalisasi ke rentang dari 0,0 hingga 1,0. Misalnya, jika aliran PCM berisi sampel 16-bit, dan nilai sampel puncak selama periode pengukuran tertentu adalah –8914, maka nilai absolut yang dicatat oleh meter puncak adalah 8914, dan nilai puncak yang dinormalisasi yang dilaporkan oleh antarmuka IAudioMeterInformation adalah 8914/32768 = 0,272.

Untuk contoh kode yang menggunakan antarmuka IAudioMeterInformation , lihat Meter Puncak.

Warisan

Antarmuka IAudioMeterInformation mewarisi dari antarmuka IUnknown . IAudioMeterInformation juga memiliki jenis anggota ini:

Metode

Antarmuka IAudioMeterInformation memiliki metode ini.

IAudioMeterInformation::GetChannelsPeakValues Metode GetChannelsPeakValues mendapatkan nilai sampel puncak untuk semua saluran di aliran audio.
IAudioMeterInformation::GetMeteringChannelCount Metode GetMeteringChannelCount mendapatkan jumlah saluran dalam aliran audio yang dipantau oleh meter puncak.
IAudioMeterInformation::GetPeakValue Metode GetPeakValue mendapatkan nilai sampel puncak untuk saluran di aliran audio.
IAudioMeterInformation::QueryHardwareSupport Metode QueryHardwareSupport meminta perangkat titik akhir audio untuk fungsi yang didukung perangkat kerasnya. (IAudioMeterInformation.QueryHardwareSupport)

Persyaratan

Klien minimum yang didukung	Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	endpointvolume.h

Lihat juga

Antarmuka Audio Inti

EndpointVolume API

IMMDevice::Activate