fungsi lineSetTerminal (tapi.h)

Artikel
03/08/2023

Fungsi lineSetTerminal memungkinkan aplikasi untuk menentukan informasi terminal mana yang terkait dengan baris, alamat, atau panggilan yang ditentukan yang akan dirutekan. Fungsi lineSetTerminal dapat digunakan saat panggilan sedang berlangsung di baris untuk memungkinkan aplikasi merutekan peristiwa ini ke perangkat yang berbeda sesuai kebutuhan.

Sintaks

LONG lineSetTerminal(
  HLINE hLine,
  DWORD dwAddressID,
  HCALL hCall,
  DWORD dwSelect,
  DWORD dwTerminalModes,
  DWORD dwTerminalID,
  DWORD bEnable
);

Parameter

hLine

Menangani ke perangkat baris terbuka.

dwAddressID

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

hCall

Menangani panggilan. Status panggilan hCall dapat menjadi status apa pun, jika dwSelect adalah CALL.

dwSelect

Apakah pengaturan terminal diminta untuk baris, alamat, atau hanya panggilan yang ditentukan. Jika baris atau alamat ditentukan, peristiwa berlaku untuk baris atau alamat itu sendiri atau berfungsi sebagai pengaturan awal default untuk semua panggilan baru di baris atau alamat. Parameter ini menggunakan salah satu konstanta LINECALLSELECT_.

dwTerminalModes

Kelas peristiwa tingkat rendah yang akan dirutekan ke terminal tertentu. Parameter ini menggunakan satu atau beberapa konstanta LINETERMMODE_.

dwTerminalID

Pengidentifikasi perangkat perangkat terminal tempat peristiwa yang diberikan akan dirutekan. Pengidentifikasi terminal adalah bilangan bulat kecil dalam kisaran nol hingga satu kurang dari dwNumTerminals, di mana dwNumTerminals, dan mode terminal yang mampu ditangani setiap terminal, dikembalikan oleh lineGetDevCaps.

Pengidentifikasi terminal ini tidak memiliki hubungan dengan pengidentifikasi perangkat lain dan didefinisikan oleh penyedia layanan menggunakan kemampuan perangkat.

bEnable

Jika TRUE, dwTerminalID valid dan kelas peristiwa yang ditentukan dirutekan ke atau dari terminal tersebut. Jika FALSE, peristiwa ini tidak dirutekan ke atau dari perangkat terminal dengan pengidentifikasi sama dengan dwTerminalID.

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_NOMEM, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSELECT, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALTERMINALID, LINEERR_UNINITIALIZED, LINEERR_INVALTERMINALMODE.

Keterangan

Aplikasi dapat menggunakan fungsi ini untuk merutekan kelas tertentu dari peristiwa baris tingkat rendah ke perangkat terminal yang ditentukan atau untuk menekan perutean peristiwa ini. Misalnya, suara dapat dirutekan ke perangkat I/O audio (headset), lampu, dan peristiwa tampilan dapat dirutekan ke perangkat telepon lokal, dan peristiwa tombol dan peristiwa dering dapat ditekan sama sekali.

Fungsi ini dapat dipanggil kapan saja, bahkan ketika panggilan aktif pada perangkat baris yang diberikan. Ini memungkinkan pengguna untuk beralih dari menggunakan telepon lokal yang diatur ke perangkat I/O audio lain. Fungsi ini dapat dipanggil beberapa kali untuk merutekan peristiwa yang sama ke beberapa terminal secara bersamaan. Untuk mengalihkan peristiwa ke terminal yang berbeda, aplikasi harus terlebih dahulu menonaktifkan perutean ke terminal yang ada lalu merutekan peristiwa ke terminal baru.

Penugasan pengidentifikasi terminal dilakukan oleh penyedia layanan baris. Kemampuan perangkat hanya menunjukkan pengidentifikasi terminal mana yang tersedia oleh penyedia layanan. Penyedia layanan yang tidak mendukung jenis perutean peristiwa ini akan menunjukkan bahwa mereka tidak memiliki perangkat terminal (dwNumTerminals di LINEDEVCAPS akan menjadi nol).

Memanggil lineSetTerminal pada baris atau alamat memengaruhi semua panggilan yang ada pada baris atau alamat tersebut, tetapi tidak memengaruhi panggilan di alamat lain. Ini juga mengatur default untuk panggilan mendatang pada baris atau alamat tersebut. Baris atau alamat yang memiliki beberapa panggilan tersambung aktif pada satu waktu dapat memiliki perutean yang berbeda yang berlaku untuk setiap panggilan.

Menonaktifkan perutean peristiwa tingkat rendah ke terminal ketika peristiwa ini saat ini tidak dirutekan ke atau dari terminal tersebut tidak selalu menghasilkan kesalahan selama fungsi berhasil (peristiwa yang ditentukan tidak dirutekan ke atau dari terminal tersebut).

Rute TAPI memanggil nada kemajuan dan pesan ke lokasi yang sama seperti yang ditetapkan oleh fungsi lineSetTerminal untuk "media". Misalnya, jika sinyal audio masuk ke telepon, maka akan sibuk sinyal (analog) atau pesan Q.931 yang menunjukkan sibuk (digital).