fungsi TSPI_lineOpen (tspi.h)

Artikel
03/09/2024

Fungsi TSPI_lineOpen membuka perangkat baris yang pengidentifikasi perangkatnya diberikan, mengembalikan handel penyedia layanan untuk perangkat. Penyedia layanan harus mempertahankan handel TAPI untuk perangkat untuk digunakan dalam panggilan berikutnya ke prosedur panggilan balik LINEEVENT .

Sintaks

LONG TSPIAPI TSPI_lineOpen(
  DWORD      dwDeviceID,
  HTAPILINE  htLine,
  LPHDRVLINE lphdLine,
  DWORD      dwTSPIVersion,
  LINEEVENT  lpfnEventProc
);

Parameter

dwDeviceID

Mengidentifikasi perangkat baris yang akan dibuka.

htLine

Handel TAPI untuk perangkat baris yang akan digunakan dalam panggilan berikutnya ke prosedur panggilan balik LINEEVENT untuk mengidentifikasi perangkat.

lphdLine

Penunjuk ke HDRVLINE tempat penyedia layanan mengisi handelnya untuk perangkat baris.

dwTSPIVersion

Versi TSPI.

lpfnEventProc

Penunjuk ke prosedur panggilan balik LINEEVENT yang disediakan oleh TAPI yang dipanggil penyedia layanan untuk melaporkan peristiwa berikutnya di telepon.

Nilai kembali

Mengembalikan nol jika fungsi berhasil, atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_ALLOCATED, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Keterangan

Penyedia layanan harus memesan sumber daya yang tidak dapat dibagikan yang diperlukan untuk mengelola garis. Namun, tindakan apa pun yang dapat ditunda ke lineMakeCall harus dilakukan. Ini adalah asumsi desain di TAPI bahwa lineOpen adalah operasi "murah". Misalnya, jika garis dibuka dalam mode monitor saja, seharusnya tidak diperlukan penyedia layanan berbasis port COMM untuk membuka port COMM.

Prosedur ini tidak sesuai langsung dengan prosedur apa pun di tingkat TAPI, di mana fungsi mengaktifkan ekstensi khusus perangkat, memilih karakteristik baris, dan mengatur deteksi jenis media disertakan dalam fungsionalitas yang ditentukan oleh lineOpen. Pada tingkat TSPI, kemampuan tambahan ini dipisahkan menjadi TSPI_lineNegotiateExtVersion, TSPI_lineSetDefaultMediaDetection , dan TSPI_lineConditionalMediaDetection.