Metode IAudioAutoGainControl::SetEnabled (devicetopology.h)

Artikel
02/26/2024

Metode SetEnabled memungkinkan atau menonaktifkan AGC.

Sintaks

HRESULT SetEnabled(
  [in] BOOL    bEnable,
  [in] LPCGUID pguidEventContext
);

Parameter

[in] bEnable

Status AGC baru. Jika parameter ini TRUE (bukan nol), metode mengaktifkan AGC. Jika FALSE, maka akan menonaktifkan AGC.

[in] pguidEventContext

Nilai konteks untuk metode IControlChangeNotify::OnNotify . Parameter ini menunjuk ke GUID konteks peristiwa. Jika panggilan SetEnabled mengubah status kontrol AGC, 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 .

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.

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Kehabisan memori.

Keterangan

Kontrol AGC yang dinonaktifkan beroperasi dalam mode pass-through. Dalam mode ini, aliran audio melewati kontrol tanpa modifikasi.

Persyaratan

Persyaratan	Nilai
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 IAudioAutoGainControl

Bagikan melalui