Antarmuka ISimpleAudioVolume (audioclient.h)
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.
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.
Antarmuka ISimpleAudioVolume mewarisi dari antarmuka IUnknown . ISimpleAudioVolume juga memiliki jenis anggota berikut:
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 | 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 |