Metode IAudioSessionControl::SetGroupingParam (audiopolicy.h)

Artikel
03/14/2023

Metode SetGroupingParam menetapkan sesi ke pengelompokan sesi.

Sintaks

HRESULT SetGroupingParam(
  [in] LPCGUID Override,
  [in] LPCGUID EventContext
);

Parameter

[in] Override

Parameter pengelompokan baru. Parameter ini harus berupa pointer non-NULL yang valid ke GUID parameter pengelompokan. Untuk informasi selengkapnya, lihat Keterangan.

[in] EventContext

Arahkan ke GUID konteks peristiwa. Jika panggilan ke metode ini menghasilkan peristiwa perubahan pengelompokan, 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 .

Mengembalikan nilai

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_POINTER	Pengelompokan Parameter adalah NULL.
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

Klien memanggil metode ini untuk mengubah parameter pengelompokan sesi. Semua sesi audio yang memiliki nilai parameter pengelompokan yang sama berada di bawah kontrol slider tingkat volume yang sama dalam program kontrol volume sistem, Sndvol. Untuk informasi selengkapnya, lihat Parameter Pengelompokan.

Klien bisa mendapatkan parameter pengelompokan saat ini untuk sesi dengan memanggil metode IAudioSessionControl::GetGroupingParam .

Jika klien belum pernah memanggil SetGroupingParam untuk menetapkan parameter pengelompokan ke sesi, sesi tersebut bukan milik pengelompokan apa pun. Sesi yang bukan milik pengelompokan apa pun memiliki slider tingkat volume khusus sendiri dalam program Sndvol.

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

Lihat juga

Antarmuka IAudioSessionControl

IAudioSessionControl::GetGroupingParam

Antarmuka IAudioSessionEvents

Bagikan melalui