Fungsi panggilan balik LINEEVENT (tspi.h)

Line_Event adalah fungsi panggilan balik yang diimplementasikan oleh TAPI dan disediakan ke penyedia layanan sebagai parameter untuk TSPI_lineOpen. Penyedia layanan memanggil fungsi ini untuk melaporkan peristiwa yang terjadi pada baris atau pada panggilan di baris.

Jenis LINEEVENT mendefinisikan penunjuk ke fungsi panggilan balik ini. Line_Event adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaks

LINEEVENT Lineevent;

void Lineevent(
  HTAPILINE htLine,
  HTAPICALL htCall,
  DWORD dwMsg,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2,
  DWORD_PTR dwParam3
)
{...}

Parameter

htLine

Handel TAPI untuk garis tempat peristiwa terjadi.

htCall

TAPI menangani panggilan tempat peristiwa terjadi jika ini adalah peristiwa terkait panggilan. Untuk peristiwa terkait baris di mana tidak ada panggilan, parameter ini diatur ke NULL.

dwMsg

Menentukan jenis peristiwa yang sedang dilaporkan. Interpretasi parameter lain dilakukan dengan cara yang berbeda sesuai dengan konteks yang ditunjukkan oleh dwMsg.

dwParam1

Parameter untuk pesan.

dwParam2

Parameter untuk pesan.

dwParam3

Parameter untuk pesan.

Mengembalikan nilai

Tidak ada

Keterangan

Status panggilan saat memanggil fungsi ini dapat menjadi status apa pun.

Penyedia layanan meneruskan nilai HTAPILINE yang disediakan ke TSPI_lineOpen sebagai parameter htLine . Ini termasuk pengidentifikasi pesan dan parameter khusus untuk peristiwa tersebut.

Fungsi ini berbeda dari fungsi panggilan balik yang ditentukan pada tingkat TAPI karena memisahkan parameter baris dan panggilan. Kedua parameter digunakan untuk beberapa pesan. Set pesan yang dapat diteruskan ke prosedur ini sedikit berbeda dari tingkat TAPI. Secara khusus, penyelesaian permintaan yang dijalankan secara asinkron dilaporkan melalui panggilan balik Completion_Proc alih-alih yang ini.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tspi.h

Lihat juga

Completion_Proc

TSPI_lineOpen