lineDevSpecificFeature (tapi.h)

  • Artikel

Fungsi lineDevSpecificFeature memungkinkan penyedia layanan untuk menyediakan akses ke fitur yang tidak ditawarkan oleh fungsi TAPI lainnya. Arti dari ekstensi ini khusus untuk perangkat, dan memanfaatkan ekstensi ini mengharuskan aplikasi untuk sepenuhnya menyadarinya.

Sintaks

LONG lineDevSpecificFeature(
  HLINE  hLine,
  DWORD  dwFeature,
  LPVOID lpParams,
  DWORD  dwSize
);

Parameter

hLine

Tangani ke perangkat baris.

dwFeature

Fitur untuk dipanggil pada perangkat baris. Parameter ini menggunakan konstanta PHONEBUTTONFUNCTION_.

lpParams

Pointer ke area memori yang digunakan untuk menahan blok parameter dependen fitur. Format blok parameter ini khusus untuk perangkat dan kontennya diteruskan oleh TAPI ke atau dari penyedia layanan.

dwSize

Ukuran buffer, dalam byte.

Nilai kembali

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_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Nilai pengembalian tambahan khusus untuk perangkat.

Keterangan

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

Fungsi ini menyediakan aplikasi dengan kemampuan emulasi tombol fitur telepon. Ketika aplikasi memanggil operasi ini, aplikasi menentukan kejadian yang setara dengan peristiwa penekanan tombol. Metode pemanggilan fitur ini tergantung pada perangkat, karena TAPI tidak mendefinisikan maknanya. Biasanya, aplikasi yang bergantung pada ekstensi khusus perangkat ini tidak berfungsi dengan lingkungan penyedia layanan lainnya.

Struktur yang diarahkan oleh 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.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tapi.h
Pustaka Tapi32.lib
DLL Tapi32.dll

Lihat juga

Referensi Layanan Telepon yang Diperluas

LINE_REPLY

Gambaran Umum Referensi TAPI 2.2