Antarmuka IAudioStreamVolume (audioclient.h)

  • Artikel

Antarmuka IAudioStreamVolume memungkinkan klien untuk mengontrol dan memantau tingkat volume untuk semua saluran dalam aliran audio. Klien mendapatkan referensi ke antarmuka IAudioStreamVolume pada objek stream dengan memanggil metode IAudioClient::GetService dengan parameter riid diatur ke REFIID IID_IAudioStreamVolume.

Tingkat volume efektif dari saluran apa pun dalam submix sesi, seperti yang didengarkan di speaker, adalah produk dari empat faktor tingkat volume berikut:

  • Tingkat volume per saluran aliran dalam sesi, yang dapat dikontrol klien melalui metode di antarmuka IAudioStreamVolume .
  • Tingkat volume per saluran sesi, yang dapat dikontrol klien melalui metode di antarmuka IChannelAudioVolume .
  • Tingkat volume master sesi, yang dapat dikontrol klien melalui metode di antarmuka ISimpleAudioVolume .
  • Tingkat volume berbasis kebijakan sesi, yang ditetapkan sistem secara dinamis ke sesi saat campuran global berubah.
Masing-masing dari empat faktor tingkat volume dalam daftar sebelumnya adalah nilai dalam rentang 0,0 hingga 1,0, di mana 0,0 menunjukkan keheningan dan 1,0 menunjukkan volume penuh (tanpa redaman). Tingkat volume yang efektif juga merupakan nilai dalam rentang 0,0 hingga 1,0.

Saat merilis instans antarmuka IAudioStreamVolume , klien harus memanggil metode Rilis antarmuka dari utas yang sama dengan panggilan ke IAudioClient::GetService yang membuat objek.

Antarmuka IAudioStreamVolume mengontrol volume saluran dalam aliran audio mode bersama. Antarmuka ini tidak berfungsi dengan aliran mode eksklusif. Untuk informasi tentang kontrol volume untuk aliran mode eksklusif, lihat Api EndpointVolume.

Warisan

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

Metode

Antarmuka IAudioStreamVolume memiliki metode ini.

 
IAudioStreamVolume::GetAllVolumes

Metode GetAllVolumes mengambil tingkat volume untuk semua saluran di aliran audio.
IAudioStreamVolume::GetChannelCount

Metode GetChannelCount mengambil jumlah saluran dalam aliran audio.
IAudioStreamVolume::GetChannelVolume

Metode GetChannelVolume mengambil tingkat volume untuk saluran yang ditentukan dalam aliran audio.
IAudioStreamVolume::SetAllVolumes

Metode SetAllVolumes mengatur tingkat volume individual untuk semua saluran dalam aliran audio.
IAudioStreamVolume::SetChannelVolume

Metode SetChannelVolume mengatur tingkat volume untuk saluran yang ditentukan dalam aliran audio.

Persyaratan

Persyaratan Nilai
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 audioclient.h

Lihat juga

Antarmuka Audio Inti

IAudioClient::GetService

Antarmuka IChannelAudioVolume

Antarmuka ISimpleAudioVolume

WASAPI