Metode IPerChannelDbLevel::SetLevelUniform (devicetopology.h)

Artikel
08/23/2023

Metode SetLevelUniform mengatur semua saluran dalam aliran audio ke tingkat volume seragam yang sama, dalam desibel.

Sintaks

HRESULT SetLevelUniform(
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

Parameter

[in] fLevelDB

Tingkat seragam baru dalam desibel.

[in] pguidEventContext

Nilai konteks untuk metode IControlChangeNotify::OnNotify . Parameter ini menunjuk ke GUID konteks peristiwa. Jika panggilan SetLevelUniform mengubah status kontrol tingkat, semua klien yang telah mendaftarkan antarmuka IControlChangeNotify dengan kontrol tersebut menerima pemberitahuan. Dalam implementasi metode OnNotify , klien dapat memeriksa GUID konteks peristiwa untuk menemukan apakah itu atau klien lain adalah sumber peristiwa perubahan kontrol. Jika penelepon menyediakan pointer NULL untuk parameter ini, metode pemberitahuan klien menerima penunjuk konteks NULL .

Mengembalikan nilai

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian menyertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Kehabisan memori.

Keterangan

Jika tingkat seragam yang ditentukan berada di luar rentang yang dilaporkan metode IPerChannelDbLevel::GetLevelRange untuk saluran tertentu, panggilan SetLevelUniform akan menjepit nilai untuk saluran tersebut ke rentang yang didukung dan berhasil diselesaikan. Panggilan berikutnya ke metode IPerChannelDbLevel::GetLevel mengambil nilai aktual yang digunakan untuk saluran tersebut.

Persyaratan


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

Lihat juga

Antarmuka IPerChannelDbLevel

IPerChannelDbLevel::GetLevel

IPerChannelDbLevel::GetLevelRange

Share via