Metode IAudioSessionManager2::RegisterDuckNotification (audiopolicy.h)

  • Artikel

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
E_POINTER
 duckNotification adalah NULL.
E_OUTOFMEMORY
 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

Lihat juga

IAudioSessionManager2

Menggunakan Perangkat Komunikasi