Metode IAudioSessionControl::GetGroupingParam (audiopolicy.h)
Metode GetGroupingParam mengambil parameter pengelompokan sesi audio.
Sintaks
HRESULT GetGroupingParam(
[out] GUID *pRetVal
);
Parameter
[out] pRetVal
Penunjuk output untuk GUID parameter pengelompokan. Parameter ini harus berupa penunjuk non-NULL yang valid ke variabel GUID yang dialokasikan pemanggil. Metode menulis parameter pengelompokan ke dalam variabel ini.
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 |
|---|---|
|
Parameter pRetVal adalah NULL. |
|
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. |
|
Layanan audio Windows tidak berjalan. |
Keterangan
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 dapat memanggil metode IAudioSessionControl::SetGroupingParam untuk mengubah parameter pengelompokan sesi.
Jika klien belum pernah memanggil SetGroupingParam untuk menetapkan parameter pengelompokan ke sesi audio, nilai parameter pengelompokan sesi GUID_NULL secara default dan panggilan ke GetGroupingParam mengambil nilai ini. Nilai parameter pengelompokan GUID_NULL menunjukkan bahwa sesi tersebut bukan milik pengelompokan apa pun. Dalam hal ini, sesi memiliki slider tingkat volume sendiri dalam program Sndvol.
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 | audiopolicy.h |