ASYNC_COMPLETION fungsi panggilan balik (tspi.h)

Completion_Proc adalah fungsi panggilan balik yang diterapkan oleh TAPI dan diberikan kepada penyedia layanan sebagai parameter untuk TSPI_providerInit. Penyedia layanan memanggil fungsi ini untuk melaporkan penyelesaian saluran atau prosedur telepon yang dijalankannya secara asinkron.

Jenis ASYNC_COMPLETION menentukan penunjuk ke fungsi panggilan balik ini. Completion_Proc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaks

ASYNC_COMPLETION AsyncCompletion;

void AsyncCompletion(
  DRV_REQUESTID dwRequestID,
  LONG lResult
)
{...}

Parameter

dwRequestID

Pengidentifikasi meneruskan permintaan asli yang dijalankan penyedia layanan secara asinkron.

lResult

Hasil operasi. Ini bisa nol untuk menunjukkan keberhasilan atau angka negatif untuk menunjukkan kesalahan. Kemungkinan nilai kesalahan spesifik yang dapat dihasilkan dari fungsi sama untuk eksekusi asinkron atau sinkron.

Mengembalikan nilai

Tidak ada

Keterangan

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

Prosedur ini disediakan oleh TAPI pada saat penyedia layanan diinisialisasi dengan fungsi TSPI_providerInit . Beberapa prosedur TSPI yang beroperasi pada perangkat saluran, panggilan, dan telepon menentukan operasi asinkron. Prosedur ini mencakup parameter dwRequestID untuk mengidentifikasi permintaan. Ketika prosedur seperti itu dipanggil, penyedia layanan dapat mengembalikan angka negatif untuk kesalahan jika seseorang segera terdeteksi, atau dwRequestID positif jika operasi berlanjut secara asinkron. Penyedia layanan harus melaporkan penyelesaian tepat sekali untuk setiap permintaan yang dijalankannya secara asinkron. Ini dilakukan dengan memanggil prosedur ini. Penyedia layanan tidak diizinkan untuk memanggil prosedur ini atau prosedur Line_Event atau Phone_Event lagi sampai prosedur ini kembali.

Penyedia layanan diizinkan untuk memanggil fungsi Completion_Proc sebelum kembali dari permintaan pertama. TAPI menjamin untuk tidak memanggil penyedia layanan dari dalam konteks Completion_Proc kecuali jika disebutkan.

Ini tidak memiliki korespondensi langsung di tingkat TAPI karena pada tingkat itu penyelesaian fungsi asinkron dilaporkan sebagai pesan yang diteruskan melalui antarmuka panggilan balik yang sama yang digunakan untuk pesan peristiwa spontan. Di tingkat TSPI, peristiwa spontan dilaporkan melalui prosedur panggilan balik Line_Event dan Phone_Event .

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tspi.h

Lihat juga

Line_Event

Phone_Event

TSPI_providerInit