Bagikan melalui

RenderSharedEventDriven

Aplikasi sampel ini menggunakan API Audio Inti untuk merender data audio ke perangkat output, yang ditentukan oleh pengguna. Sampel ini menunjukkan buffering berbasis peristiwa untuk klien penyajian dalam mode bersama. Untuk aliran mode bersama, klien berbagi buffer titik akhir dengan mesin audio.

Topik ini berisi bagian berikut.

Deskripsi

Sampel ini menunjukkan fitur berikut.

  • MMDevice API untuk enumerasi dan pemilihan perangkat multimedia.
  • WASAPI untuk operasi manajemen aliran.

Persyaratan

Hasil Versi
Windows SDK Windows 7
Visual Studio 2008

 

Mengunduh Sampel

Sampel ini tersedia di lokasi berikut.

Tempat Jalur/URL
Windows SDK \Program Files\Microsoft SDKs\Windows\v7.0\Samples\Multimedia\Audio\RenderSharedEventDriven\...

 

Membangun Sampel

Untuk membuat sampel RenderSharedEventDriven, gunakan langkah-langkah berikut:

  1. Buka shell CMD untuk Windows SDK dan ubah ke direktori sampel RenderSharedEventDriven.
  2. Jalankan perintah start WASAPIRenderSharedEventDriven.sln di direktori RenderSharedEventDriven untuk membuka proyek WASAPIRenderSharedEventDriven di jendela Visual Studio.
  3. Dari dalam jendela, pilih konfigurasi solusi Debug atau Rilis, pilih menu Build dari bilah menu, dan pilih opsi Build. Jika Anda tidak membuka Visual Studio dari shell CMD untuk SDK, Visual Studio tidak akan memiliki akses ke lingkungan build SDK. Dalam hal ini, sampel tidak akan dibuat kecuali Anda secara eksplisit mengatur variabel lingkungan MSSdk, yang digunakan dalam file proyek, WASAPIRenderSharedEventDriven.vcproj.

Menjalankan Sampel

Jika Anda berhasil membangun aplikasi demo, file yang dapat dieksekusi, WASAPIRenderSharedEventDriven.exe, dihasilkan. Untuk menjalankannya, ketik WASAPIRenderSharedEventDriven di jendela perintah diikuti oleh argumen yang diperlukan atau opsional. Contoh berikut menunjukkan cara menjalankan sampel dengan menentukan durasi pemutaran pada perangkat multimedia default.

WASAPIRenderSharedEventDriven.exe -d 20 -multimedia

Tabel berikut ini memperlihatkan argumen.

Argumen Deskripsi
-? Menampilkan bantuan.
-h Menampilkan bantuan.
-f Frekuensi gelombang sinus di Hz.
-L Latensi render audio dalam milidetik.
-d Durasi gelombang sinus dalam hitungan detik.
-m Menonaktifkan penggunaan MMCSS.
-Konsol Gunakan perangkat konsol default.
-Komunikasi Gunakan perangkat komunikasi default.
-Multimedia Gunakan perangkat multimedia default.
-Endpoint Gunakan pengidentifikasi titik akhir yang ditentukan dalam nilai pengalihan.

 

Jika aplikasi dijalankan tanpa argumen, aplikasi menghitung perangkat yang tersedia dan meminta pengguna untuk memilih perangkat untuk sesi penyajian. Setelah pengguna menentukan perangkat, aplikasi merender gelombang sinus pada 440 Hz selama 10 detik. Nilai-nilai ini dapat dimodifikasi dengan menentukan nilai sakelar -f dan -d.

RenderSharedEventDriven menunjukkan buffering berbasis peristiwa. Sampel menunjukkan cara:

  • Buat instans klien audio, konfigurasikan untuk berjalan dalam mode eksklusif, dan aktifkan buffering berbasis peristiwa dengan mengatur bendera AUDCLNT_STREAMFLAGS_EVENTCALLBACK dalam panggilan ke IAudioClient::Inisialisasi.
  • Kaitkan klien dengan sampel yang siap dirender dengan menyediakan handel peristiwa ke sistem dengan memanggil metode IAudioClient::SetEventHandle.
  • Buat utas render untuk memproses sampel dari mesin audio.
  • Periksa format campuran titik akhir perangkat untuk menentukan apakah sampel dapat dirender. Jika perangkat tidak mendukung format campuran, data dikonversi ke PCM.
  • Menangani pengalihan aliran.

Setelah sesi penyajian dimulai dan aliran dimulai, mesin audio memberi sinyal handel peristiwa yang disediakan untuk memberi tahu klien setiap kali buffer menjadi siap untuk diproses klien. Data audio juga dapat diproses dalam perulangan berbasis timer. Mode ini ditunjukkan dalam sampel RenderSharedTimerDriven.

Untuk informasi selengkapnya tentang penyajian stream, lihat Merender Stream.

Sampel SDK yang Menggunakan API Audio Inti

 

 

  • Last updated on