ISimpleAudioVolume::Metode SetMute (audioclient.h)
Metode SetMute mengatur status mematikan suara untuk sesi audio.
Sintaks
HRESULT SetMute(
[in] const BOOL bMute,
[in] LPCGUID EventContext
);
Parameter
[in] bMute
Status mematikan suara baru. TRUE memungkinkan dimatikan suaranya. FALSE menonaktifkan mematikan suara.
[in] EventContext
Arahkan ke GUID konteks peristiwa. Jika panggilan ke metode ini menghasilkan peristiwa perubahan volume, manajer sesi mengirimkan pemberitahuan ke semua klien yang telah mendaftarkan antarmuka IAudioSessionEvents dengan manajer sesi. Manajer sesi menyertakan nilai pointer EventContext dengan setiap pemberitahuan. Setelah menerima pemberitahuan, klien dapat menentukan apakah itu atau klien lain adalah sumber peristiwa dengan memeriksa nilai EventContext . Skema ini tergantung pada klien yang memilih nilai untuk parameter ini yang unik di antara semua klien dalam sesi. Jika penelepon menyediakan penunjuk NULL untuk parameter ini, metode pemberitahuan klien menerima penunjuk konteks NULL .
Mengembalikan nilai
Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian disertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Perangkat titik akhir audio telah dicabut, atau perangkat keras audio atau sumber daya perangkat keras terkait telah dikonfigurasi ulang, dinonaktifkan, dihapus, atau tidak tersedia untuk digunakan. |
|
Layanan audio Windows tidak berjalan. |
Keterangan
Metode ini menghasilkan peristiwa perubahan volume hanya jika panggilan metode mengubah status bisukan sesi dari dinonaktifkan menjadi diaktifkan, atau dari diaktifkan menjadi dinonaktifkan. Misalnya, jika bisukan diaktifkan saat panggilan terjadi, dan panggilan memungkinkan bisukan, tidak ada peristiwa yang dihasilkan.
Metode ini menerapkan status mematikan suara yang sama ke semua saluran dalam sesi audio. Perangkat titik akhir selalu menerapkan bisukan secara seragam di semua saluran dalam sesi. Tidak ada metode IChannelAudioVolume untuk mengatur status membisukan saluran individual.
Klien bisa mendapatkan status mematikan suara sesi audio dengan memanggil metode SimpleAudioVolume::GetMute .
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 | audioclient.h |