fungsi lineSetCallParams (tapi.h)
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.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | tapi.h |
Pustaka | Tapi32.lib |
DLL | Tapi32.dll |