Metode ITLegacyCallMediaControl2::D etectTones (tapi3if.h)

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

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

Sintaks

HRESULT DetectTones(
  [in] TAPI_DETECTTONE *pToneList,
  [in] long            lNumTones
);

Parameter

[in] pToneList

Penunjuk ke array TAPI_DETECTTONE yang menentukan nada yang akan dideteksi. Setiap nada dalam array memiliki bidang tag yang ditentukan aplikasi yang digunakan untuk mengidentifikasi nada individual dalam daftar ketika peristiwa deteksi nada jenis TE_TONEEVENT dilaporkan. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

[in] lNumTones

Jumlah entri dalam array yang ditentukan oleh parameter pToneList . Parameter ini diabaikan jika pToneList ADALAH NULL.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	Parameter pToneList bukan penunjuk yang valid.
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 DetectTones dan tentukan parameter pToneListNULL. Untuk mengubah daftar nada untuk dipantau, panggil metode ini dan tentukan daftar nada baru.

Persyaratan

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

Lihat juga

ITLegacyCallMediaControl2

TAPI_DETECTTONE