Metode IAudioSessionManager2::RegisterDuckNotification (audiopolicy.h)
Metode RegisterDuckNotification mendaftarkan aplikasi dengan manajer sesi untuk menerima pemberitahuan ducking.
Sintaks
HRESULT RegisterDuckNotification(
LPCWSTR sessionID,
IAudioVolumeDuckNotification *duckNotification
);
Parameter
sessionID
Penunjuk ke string yang dihentikan null yang berisi pengidentifikasi instans sesi. Aplikasi yang memutar aliran media dan ingin menyediakan perilaku redaman atau ducking aliran kustom, meneruskan pengidentifikasi instans sesi mereka sendiri. Untuk informasi selengkapnya, lihat Keterangan.
Aplikasi lain yang tidak ingin mengubah alirannya tetapi ingin mendapatkan semua pemberitahuan ducking harus melewati NULL.
duckNotification
Arahkan ke implementasi aplikasi dari antarmuka IAudioVolumeDuckNotification . Implementasi dipanggil ketika peristiwa ducking dinaikkan oleh sistem audio dan pemberitahuan dikirim ke aplikasi terdaftar.
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 |
|---|---|
|
duckNotification adalah NULL. |
|
Objek internal tidak dapat dibuat karena memori tidak cukup. |
Keterangan
Stream Attenuation atau ducking adalah fitur baru di Windows 7. Aplikasi yang memutar aliran media dapat membuat aliran bersifat berbeda ketika aliran komunikasi baru dibuka pada perangkat komunikasi default. Misalnya, aliran media asli dapat dijeda saat aliran komunikasi baru terbuka. Untuk memberikan implementasi kustom ini untuk pelemahan aliran, aplikasi dapat menolak pengalaman pelemahan aliran default dengan memanggil IAudioSessionControl::SetDuckingPreference dan kemudian mendaftarkan dirinya sendiri untuk menerima pemberitahuan ketika peristiwa sesi terjadi. Untuk peredaman aliran, peristiwa sesi dinaikkan oleh sistem saat aliran komunikasi dibuka atau ditutup pada perangkat komunikasi default. Untuk informasi selengkapnya tentang fitur ini, lihat Mendapatkan Peristiwa Ducking.
Untuk mulai menerima pemberitahuan, aplikasi memanggil metode RegisterDuckNotification untuk mendaftarkan antarmuka IAudioVolumeDuckNotification dengan manajer sesi. Ketika aplikasi tidak lagi memerlukan pemberitahuan, aplikasi memanggil metode IAudioSessionManager2::UnregisterDuckNotification untuk menghapus pendaftaran.
Aplikasi menerima pemberitahuan tentang peristiwa ducking melalui metode antarmuka IAudioVolumeDuckNotification . Aplikasi ini mengimplementasikan IAudioVolumeDuckNotification. Setelah panggilan pendaftaran berhasil, sistem memanggil metode antarmuka ini ketika peristiwa sesi terjadi.
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 |