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
AUDCLNT_E_DEVICE_INVALIDATED	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.
AUDCLNT_E_SERVICE_NOT_RUNNING	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

Lihat juga

Antarmuka IAudioSessionEvents

Antarmuka IChannelAudioVolume

Antarmuka ISimpleAudioVolume

ISimpleAudioVolume::GetMute