fungsi lineSetCallParams (tapi.h)

Artikel
03/02/2024

Fungsi lineSetCallParams memungkinkan aplikasi untuk mengubah mode pembawa dan/atau parameter tarif panggilan yang ada.

Sintaks

LONG lineSetCallParams(
  HCALL                  hCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

Parameter

hCall

Tangani ke panggilan yang parameternya akan diubah. Aplikasi harus menjadi pemilik panggilan. Status panggilan hCall dapat menjadi status apa pun kecuali diam atau terputus.

dwBearerMode

Mode pembawa baru untuk panggilan. Parameter ini menggunakan satu dan hanya satu dari konstanta LINEBEARERMODE_.

dwMinRate

Batas bawah untuk tarif data baru panggilan. Aplikasi dapat menerima tarif baru serendah ini.

dwMaxRate

Batas atas untuk tarif data baru panggilan. Ini adalah tingkat data maksimum yang dapat diterima aplikasi. Jika tingkat data yang tepat diperlukan, dwMinRate dan dwMaxRate harus sama.

lpDialParams

Penunjuk ke parameter putar nomor baru untuk panggilan, jenis LINEDIALPARAMS. Parameter ini dapat dibiarkan NULL jika parameter panggilan panggilan saat ini akan digunakan.

Mengembalikan 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_BEARERMODEUNAVAIL, LINEERR_NOTOWNER, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RATEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALRATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Keterangan

Operasi ini digunakan untuk mengubah parameter panggilan yang ada. Contoh penggunaannya termasuk mengubah mode pembawa dan/atau tingkat data panggilan yang ada.