fungsi lineDevSpecific (tapi.h)

Artikel
08/26/2023

Fungsi lineDevSpecific memungkinkan penyedia layanan untuk menyediakan akses ke fitur yang tidak ditawarkan oleh fungsi TAPI lainnya. Arti ekstensi adalah spesifik perangkat, dan memanfaatkan ekstensi ini mengharuskan aplikasi untuk sepenuhnya menyadarinya.

Sintaks

LONG lineDevSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  HCALL  hCall,
  LPVOID lpParams,
  DWORD  dwSize
);

Parameter

hLine

Menangani ke perangkat baris. Parameter ini diperlukan.

dwAddressID

Pengidentifikasi alamat pada perangkat baris yang diberikan. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi.

hCall

Menangani panggilan. Parameter ini bersifat opsional, tetapi jika ditentukan, panggilan yang diwakilinya harus milik perangkat baris hLine . Status panggilan hCall spesifik untuk perangkat.

lpParams

Penunjuk ke area memori yang digunakan untuk menahan blok parameter. Format blok parameter ini khusus perangkat dan isinya diteruskan oleh TAPI ke atau dari penyedia layanan.

dwSize

Ukuran area blok parameter, dalam byte.

Menampilkan nilai

Mengembalikan pengidentifikasi permintaan positif jika fungsi selesai secara asinkron, atau nomor kesalahan negatif jika terjadi kesalahan. Parameter dwParam2 dari pesan LINE_REPLY yang sesuai adalah nol jika fungsi berhasil, atau merupakan nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Nilai pengembalian tambahan khusus untuk perangkat.

Keterangan

Operasi ini adalah bagian dari layanan Extended Telephony. Ini menyediakan akses ke fitur khusus perangkat tanpa menentukan maknanya. Operasi ini hanya tersedia jika aplikasi telah berhasil menegosiasikan versi ekstensi khusus perangkat.

Fungsi ini menyediakan profil parameter generik. Interpretasi struktur parameter adalah spesifik perangkat. Apakah dwAddressID dan/atau hCall diharapkan valid adalah spesifik perangkat. Jika ditentukan, mereka harus milik hLine. Indikasi dan balasan yang dikirim kembali aplikasi yang spesifik perangkat harus menggunakan pesan LINE_DEVSPECIFIC .

Penyedia layanan dapat menyediakan akses ke fungsi khusus perangkat dengan menentukan parameter untuk digunakan dengan fungsi ini. Aplikasi yang ingin menggunakan ekstensi khusus perangkat ini harus berkonsultasi dengan dokumentasi khusus perangkat (dalam hal ini, khusus vendor) yang menjelaskan ekstensi apa yang ditentukan. Biasanya, aplikasi yang bergantung pada ekstensi khusus perangkat ini tidak dapat bekerja dengan lingkungan penyedia layanan lainnya.

Hati TAPI akan menulis data yang dikembalikan ke buffer yang direferensikan oleh lParam ketika pesan LINE_REPLY dikembalikan. Ini berarti bahwa buffer harus tetap valid sampai pesan LINE_REPLY dikembalikan; jika tidak, kerusakan dan pengecualian data dapat terjadi.