Metode ITLegacyCallMediaControl2::D etectTonesByCollection (tapi3if.h)

Metode DetectTonesByCollection memungkinkan dan menonaktifkan deteksi nada inband pada panggilan. Setiap kali nada tertentu terdeteksi, pesan dikirim ke aplikasi.

Metode ini ditujukan untuk Aplikasi Visual Basic dan pembuatan skrip. Aplikasi C/C++ harus menggunakan metode DetectTones sebagai gantinya.

Sintaks

HRESULT DetectTonesByCollection(
  [in] ITCollection2 *pDetectToneCollection
);

Parameter

[in] pDetectToneCollection

Penunjuk ke antarmuka ITCollection2 yang berisi kumpulan penunjuk antarmuka ITDetectTone yang mewakili nada untuk dipantau. Setiap nada dalam daftar memiliki bidang tag yang ditentukan aplikasi yang digunakan untuk mengidentifikasi nada individu saat deteksi nada dilaporkan oleh peristiwa TE_TONEEVENT . Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	Parameter pDetectToneCollection bukan penunjuk yang valid.
E_OUTOFMEMORY	Memori tidak cukup untuk mengalokasikan buffer nada.
TAPI_E_INVALCALLSTATE	Panggilan harus dalam status tersambung .

Keterangan

Metode ini diterjemahkan ke TAPI 2. xlineMonitorTones call.

Untuk membatalkan pemantauan nada yang sedang berlangsung, panggil metode DetectTonesByCollection dan tentukan koleksi kosong. Untuk mengubah daftar nada untuk dipantau, panggil metode ini dan tentukan koleksi nada baru.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tapi3if.h
Pustaka	Uuid.lib
DLL	Tapi3.dll

Lihat juga

ITCollection2

ITDetectTone

ITLegacyCallMediaControl2