fungsi TSPI_lineDevSpecificFeature (tspi.h)

  • Artikel

Fungsi TSPI_lineDevSpecificFeature digunakan sebagai mekanisme ekstensi untuk memungkinkan penyedia layanan menyediakan akses ke fitur yang tidak dijelaskan dalam operasi lain. Arti ekstensi ini spesifik untuk perangkat, dan memanfaatkan ekstensi ini membutuhkan TAPI atau aplikasi kliennya untuk sepenuhnya menyadarinya.

Sintaks

LONG TSPIAPI TSPI_lineDevSpecificFeature(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwFeature,
  LPVOID        lpParams,
  DWORD         dwSize
);

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdLine

Handel penyedia layanan ke perangkat baris.

dwFeature

Fitur yang akan dipanggil pada perangkat baris. Parameter ini menggunakan konstanta PHONEBUTTONFUNCTION_.

lpParams

Penunjuk ke area memori yang digunakan untuk menahan blok parameter yang bergantung pada fitur. Format blok parameter ini khusus untuk perangkat.

dwSize

Ukuran buffer dalam byte. Jika parameter lpParams adalah penunjuk ke string, ukuran 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_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Keterangan

Nilai pengembalian tambahan khusus untuk perangkat. Status panggilan hdCall khusus untuk perangkat.

Fungsi ini menyediakan aplikasi TAPI dengan kemampuan emulasi tombol fitur telepon. Ketika TAPI memanggil operasi ini atas nama aplikasi klien, IA menentukan kejadian "tekan tombol" yang setara. Metode pemanggilan fitur ini sangat bergantung pada perangkat, karena API tidak menentukan maknanya. Ketika aplikasi bergantung pada ekstensi khusus perangkat, aplikasi tidak berfokus dengan baik ke lingkungan penyedia layanan lainnya.

Fungsi ini disebut sebagai respons langsung terhadap aplikasi yang memanggil fungsi TAPI lineDevSpecificFeature . TAPI menerjemahkan parameter hLine yang digunakan pada tingkat TAPI ke parameter hdLine terkait yang digunakan pada tingkat TSPI. Buffer lpParams diteruskan melalui tidak dimodifikasi.

Catatan Struktur data lpParams tidak boleh berisi pointer apa pun karena tidak diterjemahkan dengan benar (dikocokkan) saat menjalankan aplikasi 16-bit dalam VERSI 32-bit TAPI dan sebaliknya.
 
Operasi ini adalah bagian dari layanan Extended Telephony. Ini hanya menyediakan akses ke fitur khusus perangkat tanpa menentukan maknanya. Operasi ini hanya tersedia jika TAPI berhasil menegosiasikan dan memilih versi ekstensi khusus perangkat.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tspi.h

Lihat juga

ASYNC_COMPLETION

LINE_DEVSPECIFICFEATURE

Konstanta PHONEBUTTONFUNCTION_