Metode IAudioSessionControl2::GetSessionIdentifier (audiopolicy.h)

Metode GetSessionIdentifier mengambil pengidentifikasi sesi audio.

Sintaks

HRESULT GetSessionIdentifier(
  [out] LPWSTR *pRetVal
);

Parameter

[out] pRetVal

Penunjuk ke alamat string karakter lebar yang dihentikan null yang menerima pengidentifikasi 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
E_POINTER	pRetVal adalah NULL.
AUDCLNT_E_DEVICE_INVALIDATED	Sesi audio terputus pada perangkat audio default.

Keterangan

Setiap sesi audio diidentifikasi oleh string pengidentifikasi. String pengidentifikasi sesi ini tidak unik di semua instans. Jika ada dua instans aplikasi yang diputar, kedua instans akan memiliki pengidentifikasi sesi yang sama. Pengidentifikasi yang diambil oleh GetSessionIdentifier berbeda dari pengidentifikasi instans sesi, yang unik di semua sesi. Untuk mendapatkan pengidentifikasi instans sesi, panggil IAudioSessionControl2::GetSessionInstanceIdentifier.

GetSessionIdentifier memeriksa apakah sesi telah terputus pada perangkat default. Ini mengambil string pengidentifikasi yang di-cache oleh klien audio untuk perangkat. Jika pengidentifikasi sesi tidak ditemukan, metode ini mengambilnya dari mesin audio.

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

Lihat juga

IAudioSessionControl2