fungsi TSPI_linePark (tspi.h)

Artikel
03/03/2024

Fungsi TSPI_linePark memarkir panggilan yang ditentukan sesuai dengan mode taman yang ditentukan.

Sintaks

LONG TSPIAPI TSPI_linePark(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  DWORD         dwParkMode,
  LPCWSTR       lpszDirAddress,
  LPVARSTRING   lpNonDirAddress
);

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdCall

Pegangan ke panggilan yang akan diparkir. Status panggilan hdCall dapat dihubungkan.

dwParkMode

Mode taman tempat panggilan akan diparkir, hanya salah satu konstanta LINEPARKMODE_.

lpszDirAddress

Penunjuk ke string Unicode yang dihentikan null yang menunjukkan alamat tempat panggilan akan diparkir saat menggunakan taman yang diarahkan. Alamat dalam format alamat yang dapat dialihkan. Parameter ini diabaikan untuk taman yang tidak diarahkan.

lpNonDirAddress

Penunjuk ke struktur jenis VARSTRING. Untuk taman yang tidak dialihkan, alamat tempat panggilan diparkir dikembalikan dalam struktur ini. Parameter ini diabaikan untuk taman yang diarahkan. Dalam struktur VARSTRING , dwStringFormat harus diatur ke STRINGFORMAT_ASCII (buffer string ASCII yang berisi string yang dihentikan null), dan NULL yang mengakhiri diperhitungkan dalam dwStringSize. Jika memori yang ditujukkan oleh parameter lpNonDirAddress tidak cukup besar untuk alamat yang diminta, fungsi TSPI_linePark mengembalikan LINEERR_STRUCTURETOOSMALL.

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_NOMEM, LINEERR_INVALPARKMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL.

Keterangan

Semua anggota struktur VARSTRING , kecuali dwTotalSize, diisi oleh penyedia layanan. Anggota dwTotalSize diisi oleh TAPI, dan penyedia layanan tidak boleh menimpa nilai ini.

Di bawah taman yang diarahkan, aplikasi klien (melalui TAPI) menentukan alamat tempat ia ingin memarkir panggilan. Di bawah taman yang tidak dialihkan, sakelar menentukan alamat dan menyediakannya ke TAPI. Dalam kedua kasus, panggilan yang diparkir dapat dipisahkan dengan menentukan alamat ini.

Panggilan yang diparkir biasanya memasuki status panggilan diam setelah berhasil diparkir. Penyedia layanan melaporkan status baru menggunakan pesan LINE_CALLSTATE . TSPI_lineUnpark berikutnya membuat handel panggilan baru yang berbeda, terlepas dari apakah TSPI_lineCloseCall telah menghancurkan handel lama.

Beberapa sakelar dapat mengingatkan pengguna setelah panggilan diparkir untuk waktu yang lama. Penyedia layanan melaporkan ini ke TAPI sebagai panggilan penawaran dengan alasan panggilan yang diatur ke pengingat (jika ini diketahui).