fungsi TSPI_lineSetCallParams (tspi.h)

Artikel
08/26/2023

Fungsi TSPI_lineSetCallParams menetapkan parameter tertentu untuk panggilan yang ada.

Sintaks

LONG TSPIAPI TSPI_lineSetCallParams(
  DRV_REQUESTID          dwRequestID,
  HDRVCALL               hdCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdCall

Handel ke panggilan yang parameternya akan diubah. Status panggilan dapat menjadi status apa pun kecuali diam dan terputus.

dwBearerMode

Mode pembawa baru untuk panggilan. Parameter dwBearerMode hanya dapat memiliki salah satu konstanta LINEBEARERMODE_.

dwMinRate

Batas bawah untuk tarif data baru panggilan. TAPI dapat menerima tarif baru serendah ini. TAPI tidak memvalidasi parameter ini ketika fungsi ini dipanggil.

dwMaxRate

Batas atas untuk tarif data baru panggilan. Ini adalah tingkat data maksimum yang diinginkan TAPI. Nilai yang sama untuk dwMinRate dan dwMaxRate menunjukkan bahwa tingkat data yang tepat diperlukan. TAPI tidak memvalidasi parameter ini ketika fungsi ini dipanggil.

lpDialParams

Penunjuk ke parameter putar nomor baru untuk panggilan, jenis LINEDIALPARAMS. Jika parameter ini ADALAH NULL, ini menunjukkan bahwa parameter panggilan panggilan saat ini akan digunakan.

Nilai kembali

Mengembalikan dwRequestID, atau nomor kesalahan jika terjadi kesalahan. Parameter aktual lResult dari ASYNC_COMPLETION yang sesuai adalah nol jika fungsi berhasil, atau nomor kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_INVALCALLHANDLE, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_NOMEM, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALRATE, LINEERR_RESOURCEUNAVAIL, LINEERR_BEARERMODEUNAVAIL.

Keterangan

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