Antarmuka IMFSimpleAudioVolume (mfidl.h)

Mengontrol tingkat volume master sesi audio yang terkait dengan penyaji audio streaming (SAR) dan sumber pengambilan audio.

SAR dan sumber pengambilan audio mengekspos antarmuka ini sebagai layanan. Untuk mendapatkan penunjuk ke antarmuka, panggil IMFGetService::GetService. Untuk SAR, gunakan pengidentifikasi layanan MR_POLICY_VOLUME_SERVICE. Untuk sumber pengambilan audio, gunakan pengidentifikasi layanan MR_CAPTURE_POLICY_VOLUME_SERVICE. Anda dapat memanggil GetService langsung di SAR atau sumber pengambilan audio, atau memanggilnya di Sesi Media.

Warisan

Antarmuka IMFSimpleAudioVolume mewarisi dari antarmuka IUnknown . IMFSimpleAudioVolume juga memiliki jenis anggota berikut:

Metode

Antarmuka IMFSimpleAudioVolume memiliki metode ini.

 
IMFSimpleAudioVolume::GetMasterVolume

Mengambil tingkat volume master.
IMFSimpleAudioVolume::GetMute

Kueri apakah audio dimatikan suaranya. (IMFSimpleAudioVolume.GetMute)
IMFSimpleAudioVolume::SetMasterVolume

Mengatur tingkat volume master.
IMFSimpleAudioVolume::SetMute

Mematikan suara atau menyalakan suara audio. (IMFSimpleAudioVolume.SetMute)

Keterangan

Untuk mengontrol tingkat volume saluran individual, gunakan antarmuka IMFAudioStreamVolume . Antarmuka IMFAudioStreamVolume hanya didukung oleh SAR.

Volume dinyatakan sebagai tingkat redaman, di mana 0,0 menunjukkan keheningan dan 1,0 menunjukkan volume penuh (tanpa redaman). Untuk setiap saluran, tingkat redaman adalah produk dari:

  • Tingkat volume master sesi audio.
  • Tingkat volume saluran.
Misalnya, jika volume master adalah 0,8 dan volume saluran adalah 0,5, redaman untuk saluran tersebut adalah 0,8 × 0,5 = 0,4. Tingkat volume dapat melebihi 1,0 (keuntungan positif), tetapi mesin audio mengklip sampel audio apa pun yang melebihi nol desibel. Untuk mengubah tingkat volume saluran individual, gunakan antarmuka IMFAudioStreamVolume .

Gunakan rumus berikut untuk mengonversi tingkat volume ke skala desibel (dB):

Redaman (dB) = 20 * log10(Level)

Misalnya, tingkat volume 0,50 mewakili redaman 6,02 dB.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header mfidl.h

Lihat juga

Antarmuka Media Foundation

Perender Audio Streaming