TSPI_lineDevSpecific (tspi.h)

Artikel
08/26/2023

Fungsi TSPI_lineDevSpecific digunakan sebagai mekanisme ekstensi umum untuk memungkinkan penyedia layanan menyediakan akses ke fitur yang tidak dijelaskan dalam operasi lain. Arti ekstensi khusus perangkat, dan untuk memanfaatkan ekstensi ini, aplikasi harus sepenuhnya menyadarinya.

Sintaks

LONG TSPIAPI TSPI_lineDevSpecific(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HDRVCALL      hdCall,
  LPVOID        lpParams,
  DWORD         dwSize
);

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdLine

Pegangan penyedia layanan ke jalur yang akan dioperasikan.

dwAddressID

Alamat pada baris yang ditentukan untuk dioperasikan. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi.

hdCall

Pegangan penyedia layanan terhadap panggilan yang akan dioperasikan. Bidang ini mungkin memiliki nilai NULL. Status panggilan hdCall spesifik untuk perangkat.

lpParams

Pointer ke area memori yang digunakan untuk menahan blok parameter. Format blok parameter ini khusus untuk perangkat.

dwSize

Ukuran dalam byte area blok parameter. Jika parameter lpParams adalah penunjuk ke string, ukurannya harus menyertakan terminator null .

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_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Keterangan

Nilai pengembalian tambahan khusus untuk perangkat.

Operasi ini menyediakan profil parameter generik. Interpretasi struktur parameter adalah spesifik perangkat. TAPI selalu menentukan parameter hdLine . Apakah dwAddressID dan/atau hdCall diharapkan valid adalah spesifik perangkat. Jika ditentukan, mereka harus milik hdLine. Indikasi dan balasan yang dikirim kembali ke aplikasi yang spesifik perangkat menggunakan pesan LINE_DEVSPECIFIC .

Fungsi ini dipanggil sebagai respons langsung terhadap aplikasi yang memanggil fungsi TAPI lineDevSpecific. TAPI menerjemahkan parameter hLine dan hdCall yang digunakan pada tingkat TAPI ke parameter hdLine dan hdCall yang sesuai yang digunakan pada tingkat TSPI. Buffer lpParams diteruskan tanpa diubah.

Catatan Struktur data lpParams tidak boleh berisi pointer apa pun karena tidak akan diterjemahkan dengan benar (dikocok) saat menjalankan aplikasi 16-bit dalam versi 32-bit TAPI dan sebaliknya.

Penyedia layanan dapat menyediakan akses ke fungsi khusus perangkat dengan menentukan parameter untuk digunakan dengan operasi ini. Aplikasi yang ingin menggunakan ekstensi khusus perangkat ini harus berkonsultasi dengan dokumentasi khusus perangkat (dalam hal ini yang berarti khusus vendor) yang menjelaskan ekstensi mana yang ditentukan.

Catatan Aplikasi yang bergantung pada ekstensi khusus perangkat tidak portabel dalam bekerja dengan lingkungan penyedia layanan lainnya. Gunakan ekstensi khusus vendor.

Operasi ini adalah bagian dari layanan Extended Telephony. Ini hanya menyediakan akses ke fitur khusus perangkat tanpa menentukan maknanya. Operasi ini hanya tersedia jika aplikasi telah berhasil menegosiasikan dan memilih versi ekstensi khusus perangkat.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tspi.h

Lihat juga

ASYNC_COMPLETION

LINE_DEVSPECIFIC

TSPI_lineNegotiateExtVersion