Antarmuka ISimpleAudioVolume (audioclient.h)

  • Artikel

Antarmuka ISimpleAudioVolume memungkinkan klien mengontrol tingkat volume master sesi audio. Metode IAudioClient::Initialize menginisialisasi objek stream dan menetapkan aliran ke sesi audio. Klien mendapatkan referensi ke antarmuka ISimpleAudioVolume pada objek stream dengan memanggil metode IAudioClient::GetService dengan parameter riid diatur ke REFIID IID_ISimpleAudioVolume.

Atau, klien dapat memperoleh antarmuka ISimpleAudioVolume dari sesi yang ada tanpa harus terlebih dahulu membuat objek stream dan menambahkan aliran ke sesi. Sebagai gantinya, klien memanggil metode IAudioSessionManager::GetSimpleAudioVolume dengan GUID sesi.

Tingkat volume efektif 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 master sesi, yang dapat dikontrol klien melalui metode di antarmuka ISimpleAudioVolume .
  • Tingkat volume per saluran sesi, yang dapat dikontrol klien melalui metode di antarmuka IChannelAudioVolume .
  • 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 efektif juga merupakan nilai dalam rentang 0,0 hingga 1,0.

Aplikasi audio umum tidak mengubah tingkat volume sesi. Sebaliknya, mereka mengandalkan pengguna untuk mengatur tingkat volume ini melalui program Sndvol. Sndvol hanya memodifikasi tingkat volume master sesi. Secara default, manajer sesi mengatur tingkat volume master ke 1.0 pada aktivasi awal sesi. Perubahan volume berikutnya oleh Sndvol atau klien lain terus-menerus di seluruh komputer dimulai ulang.

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

Antarmuka ISimpleAudioVolume mengontrol volume sesi audio. Sesi audio adalah kumpulan aliran mode bersama. Antarmuka ini tidak berfungsi dengan aliran mode eksklusif. Untuk informasi tentang kontrol volume untuk aliran mode eksklusif, lihat EndpointVolume API.

Warisan

Antarmuka ISimpleAudioVolume mewarisi dari antarmuka IUnknown . ISimpleAudioVolume juga memiliki jenis anggota berikut:

Metode

Antarmuka ISimpleAudioVolume memiliki metode ini.

 
ISimpleAudioVolume::GetMasterVolume

Metode GetMasterVolume mengambil tingkat volume klien untuk sesi audio.
ISimpleAudioVolume::GetMute

Metode GetMute mengambil status mematikan suara saat ini untuk sesi audio.
ISimpleAudioVolume::SetMasterVolume

Metode SetMasterVolume mengatur tingkat volume master untuk sesi audio.
ISimpleAudioVolume::SetMute

Metode SetMute mengatur status mematikan suara untuk sesi 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

IAudioClient::Initialize

Antarmuka IAudioStreamVolume

Antarmuka IChannelAudioVolume

WASAPI