fungsi lineMonitorMedia (tapi.h)

Fungsi lineMonitorMedia memungkinkan dan menonaktifkan deteksi jenis media (mode) pada panggilan yang ditentukan. Ketika jenis media terdeteksi, pesan dikirim ke aplikasi. Untuk informasi selengkapnya, lihat ITLegacyCallMediaControl::MonitorMedia.

Sintaks

LONG lineMonitorMedia(
  HCALL hCall,
  DWORD dwMediaModes
);

Parameter

hCall

Tangani panggilan. Status panggilan hCall dapat menjadi status apa pun kecuali diam.

dwMediaModes

Jenis media yang akan dipantau. Jika parameter ini nol, parameter membatalkan semua deteksi jenis media. Parameter ini menggunakan satu atau beberapa konstanta LINEMEDIAMODE_.

Nilai kembali

Mengembalikan nol jika permintaan berhasil atau nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Keterangan

Jenis media yang ditentukan dengan lineOpen hanya berkaitan dengan memungkinkan deteksi jenis media ini oleh penyedia layanan untuk tujuan menyerahkan panggilan masuk baru ke aplikasi yang tepat. Mereka tidak berdampak pada pesan pemberitahuan mode media apa pun yang diharapkan karena pemanggilan lineMonitorMedia sebelumnya.

Fungsi ini dianggap berhasil jika pemantauan jenis media telah dimulai dengan benar, bukan ketika pemantauan jenis media telah dihentikan. Pemantauan media untuk jenis media tertentu tetap berlaku sampai secara eksplisit dinonaktifkan dengan memanggil lineMonitorMedia dengan parameter dwMediaModes diatur ke nol, sampai panggilan beralih ke diam, atau ketika aplikasi membatalkan handel panggilannya untuk panggilan. Fungsi lineMonitorMedia terutama merupakan mekanisme pelaporan peristiwa. Jenis media (mode) panggilan, seperti yang ditunjukkan dalam LINECALLINFO, tidak terpengaruh oleh deteksi penyedia layanan dari jenis media. Hanya aplikasi pengontrol yang dapat mengubah jenis media panggilan.

Pemantauan media default yang dilakukan oleh penyedia layanan sesuai dengan gabungan semua jenis media yang ditentukan pada lineOpen.

Meskipun fungsi ini dapat dipanggil dalam status panggilan apa pun, jenis media panggilan biasanya hanya dapat dideteksi saat panggilan berada dalam status panggilan tertentu. Status ini dapat spesifik untuk perangkat. Misalnya, di ISDN, pesan dapat menunjukkan jenis media aliran media sebelum aliran media ada. Demikian pula, dering khusus atau informasi pengidentifikasi yang disebut tentang panggilan dapat digunakan untuk mengidentifikasi jenis media panggilan. Jika tidak, panggilan mungkin harus dijawab (panggilan dalam status tersambung ) untuk memungkinkan penyedia layanan menentukan jenis media panggilan dengan memfilter aliran media. Karena memfilter aliran media panggilan menyiratkan overhead komputasi, aplikasi harus menonaktifkan pemantauan media saat tidak diperlukan. Secara default, pemantauan media diaktifkan untuk panggilan yang baru masuk, karena jenis media panggilan memilih aplikasi yang harus menangani panggilan.

Aplikasi keluar yang berkaitan dengan jenis media suara mungkin ingin memantau panggilan untuk keheningan (nada) untuk membedakan siapa atau apa yang disebut akhir panggilan. Misalnya, seseorang di rumah dapat menjawab panggilan hanya dengan "halo" singkat. Seseorang di kantor dapat memberikan salam yang lebih panjang, menunjukkan nama dan nama perusahaan. Mesin penjawab biasanya dapat memiliki salam yang lebih panjang.

Karena deteksi mode media yang diaktifkan oleh lineMonitorMedia diimplementasikan sebagai operasi baca-saja dari aliran media panggilan, itu tidak mengganggu.

Pemantauan media pada panggilan konferensi hanya berlaku untuk parameter hConfCall , bukan untuk panggilan yang berpartisipasi individu.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tapi.h
Pustaka	Tapi32.lib
DLL	Tapi32.dll

Lihat juga

LINECALLINFO

Fungsi Layanan Garis Tambahan

Gambaran Umum Referensi TAPI 2.2

lineOpen