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

Lihat juga

Antarmuka Audio Inti

IAudioClient::GetService

IAudioClient::Initialize

IAudioSessionManager::GetAudioSessionControl

WASAPI