fungsi lineGetRequest (tapi.h)

Artikel
08/26/2023

Fungsi lineGetRequest mengambil permintaan by-proxy berikutnya untuk mode permintaan yang ditentukan.

Sintaks

LONG lineGetRequest(
  HLINEAPP hLineApp,
  DWORD    dwRequestMode,
  LPVOID   lpRequestBuffer
);

Parameter

hLineApp

Handel penggunaan aplikasi untuk bagian baris TAPI.

dwRequestMode

Jenis permintaan yang akan diperoleh. Ketahuilah bahwa dwRequestMode hanya dapat memiliki satu set bit. Parameter ini menggunakan satu dan hanya satu dari konstanta LINEREQUESTMODE_.

lpRequestBuffer

Penunjuk ke buffer memori tempat parameter permintaan akan ditempatkan. Ukuran buffer dan interpretasi data yang ditempatkan di buffer tergantung pada mode permintaan. Buffer yang dialokasikan aplikasi diasumsikan memiliki ukuran yang cukup untuk menahan permintaan.

Jika dwRequestMode LINEREQUESTMODE_MAKECALL, interpretasikan konten buffer permintaan menggunakan struktur LINEREQMAKECALL .

LINEREQUESTMODE_MEDIACALL sudah usang. Untuk informasi selengkapnya, lihat tapiRequestMediaCall.

Nilai kembali

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

LINEERR_INVALAPPHANDLE, LINEERR_NOTREGISTERED, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NOREQUEST.

Keterangan

Aplikasi yang mendukung telefoni dapat meminta agar panggilan dilakukan atas namanya dengan memanggil tapiRequestMakeCall. Permintaan ini diantrekan oleh TAPI dan aplikasi prioritas tertinggi yang telah terdaftar untuk menangani permintaan dikirimi pesan LINE_REQUEST dengan indikasi mode permintaan yang tertunda. Biasanya, aplikasi ini adalah aplikasi kontrol panggilan pengguna. Pesan LINE_REQUEST menunjukkan bahwa nol atau lebih permintaan mungkin tertunda untuk diproses oleh aplikasi terdaftar; setelah menerima LINE_REQUEST, aplikasi penerima bertanggung jawab untuk memanggil lineGetRequest sampai LINEERR_NOREQUEST dikembalikan, menunjukkan bahwa tidak ada lagi permintaan yang tertunda.

Selanjutnya, aplikasi kontrol panggilan yang menerima pesan ini memanggil lineGetRequest, menentukan mode permintaan dan buffer yang cukup besar untuk menahan permintaan. Aplikasi kontrol panggilan kemudian menginterpretasikan dan menjalankan permintaan.

Setelah eksekusi lineGetRequest, TAPI menghapus menyeluruh permintaan dari antrean internalnya, membuat ruang tersedia untuk permintaan berikutnya. Oleh karena itu dimungkinkan bagi pesan LINE_REQUEST baru untuk segera diterima setelah eksekusi lineGetRequest, jika aplikasi yang sama atau lain mengeluarkan permintaan lain. Merupakan tanggung jawab aplikasi penerima permintaan untuk menangani skenario ini dengan beberapa mekanisme; misalnya, dengan mencatat LINE_REQUEST tambahan dan menangguhkan baris berikutnyaGetRequest hingga pemrosesan permintaan sebelumnya selesai, dengan mendapatkan permintaan dan buffer berikutnya seperlunya, atau dengan cara lain yang sesuai.

LINE_REQUEST berikutnya tidak boleh diabaikan karena tidak diulangi oleh TAPI.