Metode IAudioEndpointVolume::SetMute (endpointvolume.h)

Metode SetMute mengatur status mematikan suara aliran audio yang masuk atau meninggalkan perangkat titik akhir audio.

Sintaks

HRESULT SetMute(
  [in] BOOL    bMute,
  [in] LPCGUID pguidEventContext
);

Parameter

[in] bMute

Status mematikan suara baru. Jika bMuteTRUE, metode akan mematikan suara aliran. Jika FALSE, metode akan menonaktifkan bisukan.

[in] pguidEventContext

Nilai konteks untuk metode IAudioEndpointVolumeCallback::OnNotify . Parameter ini menunjuk ke GUID konteks peristiwa. Jika panggilan SetMute mengubah status bisukan titik akhir, semua klien yang telah mendaftarkan antarmuka IAudioEndpointVolumeCallback dengan titik akhir tersebut akan menerima pemberitahuan. Dalam implementasi metode OnNotify , klien dapat memeriksa GUID konteks peristiwa untuk menemukan apakah itu atau klien lain adalah sumber peristiwa perubahan kontrol. Jika penelepon menyediakan pointer NULL untuk parameter ini, rutinitas pemberitahuan menerima nilai GUID konteks GUID_NULL.

Menampilkan nilai

Jika metode berhasil dan status membisukan berubah, metode akan mengembalikan S_OK. Jika metode berhasil dan status bisukan baru sama dengan status matikan suara sebelumnya, metode akan mengembalikan S_FALSE. Jika metode gagal, kemungkinan kode pengembalian disertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Kehabisan memori.

Keterangan

Untuk contoh kode yang memanggil SetMute, lihat Kontrol Volume Titik Akhir.

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	endpointvolume.h

Lihat juga

Antarmuka IAudioEndpointVolume

Antarmuka IAudioEndpointVolumeCallback

IAudioEndpointVolumeCallback::OnNotify