IAudioSessionManager::Metode GetAudioSessionControl (audiopolicy.h)
Metode GetAudioSessionControl mengambil kontrol sesi audio.
Sintaks
HRESULT GetAudioSessionControl(
[in] LPCGUID AudioSessionGuid,
[in] DWORD StreamFlags,
[out] IAudioSessionControl **SessionControl
);
Parameter
[in] AudioSessionGuid
Penunjuk ke GUID sesi. Jika GUID tidak mengidentifikasi sesi yang telah dibuka sebelumnya, panggilan akan membuka sesi baru tetapi kosong. Program Sndvol tidak menampilkan kontrol tingkat volume untuk sesi kecuali berisi satu atau beberapa aliran aktif. Jika parameter ini NULL atau menunjuk ke nilai GUID_NULL, metode menetapkan aliran ke sesi default.
[in] StreamFlags
Menentukan status bendera untuk aliran audio.
[out] SessionControl
Penunjuk ke variabel penunjuk tempat metode menulis penunjuk ke antarmuka IAudioSessionControl dari objek kontrol sesi audio. Pemanggil bertanggung jawab untuk merilis antarmuka, ketika tidak lagi diperlukan, dengan memanggil metode Rilis antarmuka. Jika panggilan gagal, *SessionControl adalah NULL.
Menampilkan 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 |
|---|---|
|
Aliran audio belum berhasil diinisialisasi. |
|
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. |
|
Parameter SessionControl adalah NULL. |
|
Kehabisan memori. |
Keterangan
Untuk contoh kode yang memanggil metode ini, lihat Peristiwa Audio untuk Aplikasi Audio Warisan.
Persyaratan
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | audiopolicy.h |