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
AUDCLNT_E_NOT_INITIALIZED	Aliran audio belum berhasil diinisialisasi.
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.
E_POINTER	Parameter SessionControl adalah NULL.
E_MEMORY	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

Lihat juga

Antarmuka IAudioSessionControl

Antarmuka IAudioSessionManager