IAudioSessionControl::Metode GetState (audiopolicy.h)
Metode GetState mengambil status sesi audio saat ini.
Sintaks
HRESULT GetState(
[out] AudioSessionState *pRetVal
);
Parameter
[out] pRetVal
Arahkan ke variabel tempat metode menulis status sesi saat ini. Status harus salah satu nilai enumerasi AudioSessionState berikut:
AudioSessionStateActive
AudioSessionStateInactive
AudioSessionStateExpired
Nilai-nilai ini menunjukkan bahwa status sesi aktif, tidak aktif, atau kedaluwarsa, masing-masing. Untuk informasi selengkapnya, lihat Keterangan.
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
Metode ini menunjukkan apakah status sesi aktif, tidak aktif, atau kedaluwarsa. Status aktif jika sesi memiliki satu atau beberapa aliran yang sedang berjalan. Status berubah dari aktif menjadi tidak aktif saat aliran terakhir yang berjalan dalam sesi berhenti. Status sesi berubah menjadi kedaluwarsa ketika klien menghancurkan aliran terakhir dalam sesi dengan merilis semua referensi ke objek stream.
Program Sndvol menampilkan kontrol volume dan bisukan untuk sesi yang berada dalam status aktif dan tidak aktif. Saat sesi kedaluwarsa, Sndvol berhenti menampilkan kontrol untuk sesi tersebut. Jika sesi sebelumnya telah kedaluwarsa, tetapi status sesi berubah menjadi aktif (karena aliran dalam sesi mulai berjalan) atau tidak aktif (karena klien menetapkan aliran baru ke sesi), Sndvol melanjutkan menampilkan kontrol untuk sesi tersebut.
Klien membuat aliran dengan memanggil metode IAudioClient::Initialize . Pada saat membuat aliran, klien menetapkan aliran ke sesi. Sesi dimulai saat klien menetapkan aliran pertama ke sesi. Awalnya, sesi dalam keadaan tidak aktif. Status sesi berubah menjadi aktif saat streaming pertama dalam sesi mulai berjalan. Sesi berakhir ketika klien merilis referensi akhir ke objek stream terakhir yang tersisa dalam sesi.
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 |