Antarmuka IAudioSessionControl (audiopolicy.h)
Antarmuka IAudioSessionControl memungkinkan klien mengonfigurasi parameter kontrol untuk sesi audio dan memantau peristiwa dalam sesi. Metode IAudioClient::Initialize menginisialisasi objek stream dan menetapkan aliran ke sesi audio. Klien mendapatkan referensi ke antarmuka IAudioSessionControl pada objek stream dengan memanggil metode IAudioClient::GetService dengan parameter riid diatur ke REFIID IID_IAudioSessionControl.
Atau, klien dapat memperoleh antarmuka IAudioSessionControl dari sesi yang ada tanpa harus terlebih dahulu membuat objek stream dan menambahkan aliran ke sesi. Sebagai gantinya, klien memanggil metode IAudioSessionManager::GetAudioSessionControl dengan parameter AudioSessionGuid yang diatur ke GUID sesi.
Klien dapat mendaftar untuk menerima pemberitahuan dari manajer sesi ketika klien mengubah parameter sesi melalui metode di antarmuka IAudioSessionControl .
Saat merilis instans antarmuka IAudioSessionControl , klien harus memanggil metode Rilis antarmuka dari utas yang sama dengan panggilan ke IAudioClient::GetService yang membuat objek.
Antarmuka IAudioSessionControl mengontrol sesi audio. Sesi audio adalah kumpulan aliran mode bersama. Antarmuka ini tidak berfungsi dengan aliran mode eksklusif.
Untuk contoh kode yang menggunakan antarmuka IAudioSessionControl , lihat Peristiwa Audio untuk Aplikasi Audio Warisan.
Warisan
Antarmuka IAudioSessionControl mewarisi dari antarmuka IUnknown . IAudioSessionControl juga memiliki jenis anggota ini:
Metode
Antarmuka IAudioSessionControl memiliki metode ini.
| IAudioSessionControl::GetDisplayName Metode GetDisplayName mengambil nama tampilan untuk sesi audio. |
| IAudioSessionControl::GetGroupingParam Metode GetGroupingParam mengambil parameter pengelompokan sesi audio. |
| IAudioSessionControl::GetIconPath Metode GetIconPath mengambil jalur untuk ikon tampilan untuk sesi audio. |
| IAudioSessionControl::GetState Metode GetState mengambil status sesi audio saat ini. |
| IAudioSessionControl::RegisterAudioSessionNotification Metode RegisterAudioSessionNotification mendaftarkan klien untuk menerima pemberitahuan peristiwa sesi, termasuk perubahan status aliran. |
| IAudioSessionControl::SetDisplayName Metode SetDisplayName menetapkan nama tampilan ke sesi saat ini. |
| IAudioSessionControl::SetGroupingParam Metode SetGroupingParam menetapkan sesi ke pengelompokan sesi. |
| IAudioSessionControl::SetIconPath Metode SetIconPath menetapkan ikon tampilan ke sesi saat ini. |
| IAudioSessionControl::UnregisterAudioSessionNotification Metode UnregisterAudioSessionNotification menghapus pendaftaran sebelumnya oleh klien untuk menerima pemberitahuan. |
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 |