Metode ISimpleAudioVolume::SetMasterVolume (audioclient.h)

Artikel
03/14/2023

Metode SetMasterVolume mengatur tingkat volume master untuk sesi audio.

Sintaks

HRESULT SetMasterVolume(
  [in] float   fLevel,
  [in] LPCGUID EventContext
);

Parameter

[in] fLevel

Tingkat volume master baru. Tingkat volume yang valid berada dalam rentang 0,0 hingga 1,0.

[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 pointer NULL untuk parameter ini, metode pemberitahuan klien menerima penunjuk konteks NULL .

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian menyertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Parameter fLevel tidak dalam rentang 0,0 hingga 1,0.
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 dibuat 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 tingkat volume sesi. Misalnya, jika tingkat volume adalah 0,4 ketika panggilan terjadi, dan panggilan mengatur tingkat volume ke 0,4, tidak ada peristiwa yang dihasilkan.

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 IAudioSessionEvents

Antarmuka ISimpleAudioVolume

ISimpleAudioVolume::GetMasterVolume

Bagikan melalui