Metode IAudioSessionControl2::GetSessionInstanceIdentifier (audiopolicy.h)
Metode GetSessionInstanceIdentifier mengambil pengidentifikasi instans sesi audio.
Sintaks
HRESULT GetSessionInstanceIdentifier(
[out] LPWSTR *pRetVal
);
Parameter
[out] pRetVal
Penunjuk ke alamat string karakter lebar yang dihentikan null yang menerima pengidentifikasi instans tertentu dari sesi audio. String dialokasikan oleh metode ini dan harus dirilis oleh pemanggil dengan memanggil CoTaskMemFree. Untuk informasi tentang CoTaskMemFree, lihat dokumentasi Windows SDK.
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.
| Mengembalikan nilai | Deskripsi |
|---|---|
|
pRetVal adalah NULL. |
|
Sesi audio terputus pada perangkat audio default. |
Keterangan
Setiap instans sesi audio diidentifikasi oleh string unik. String ini mewakili instans tertentu dari sesi audio dan, tidak seperti pengidentifikasi sesi, unik di semua instans. Jika ada dua instans aplikasi yang diputar, mereka akan memiliki pengidentifikasi instans sesi yang berbeda. Pengidentifikasi yang diambil oleh GetSessionInstanceIdentifier berbeda dari pengidentifikasi sesi, yang dibagikan oleh semua instans sesi. Untuk mendapatkan pengidentifikasi sesi, panggil IAudioSessionControl2::GetSessionIdentifier.
GetSessionInstanceIdentifier memeriksa apakah sesi telah terputus pada perangkat default. Ini mengambil string pengidentifikasi yang di-cache oleh klien audio untuk perangkat. Jika pengidentifikasi instans sesi tidak ditemukan, metode ini mengambilnya dari mesin audio. Misalnya kode tentang mendapatkan pengidentifikasi instans sesi, lihat Mendapatkan Peristiwa Ducking dari Perangkat Komunikasi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | audiopolicy.h |