fungsi phoneDevSpecific (tapi.h)

Artikel
03/08/2023

Fungsi phoneDevSpecific digunakan sebagai mekanisme ekstensi umum untuk mengaktifkan implementasi API Telepon untuk menyediakan fitur yang tidak dijelaskan dalam fungsi TAPI lainnya. Arti ekstensi ini khusus untuk perangkat.

Sintaks

LONG phoneDevSpecific(
  HPHONE hPhone,
  LPVOID lpParams,
  DWORD  dwSize
);

Parameter

hPhone

Menangani ke perangkat telepon.

lpParams

Penunjuk ke area memori yang digunakan untuk menahan blok parameter. Interpretasinya spesifik untuk perangkat. Konten blok parameter diteruskan tidak berubah ke atau dari penyedia layanan oleh TAPI.

dwSize

Ukuran area blok parameter, dalam byte.

Nilai kembali

Mengembalikan pengidentifikasi permintaan positif jika fungsi selesai secara asinkron atau nomor kesalahan negatif jika terjadi kesalahan. Parameter dwParam2 dari pesan PHONE_REPLY yang sesuai adalah nol jika fungsi berhasil atau merupakan nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED.

Nilai pengembalian tambahan khusus untuk perangkat.

Keterangan

Operasi ini menyediakan profil parameter generik. Interpretasi blok parameter adalah spesifik perangkat. Indikasi dan balasan yang spesifik untuk perangkat harus menggunakan pesan PHONE_DEVSPECIFIC .

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 (khusus vendor) yang menjelaskan ekstensi mana yang ditentukan. Biasanya, aplikasi yang bergantung pada ekstensi khusus perangkat ini tidak portabel untuk bekerja dengan lingkungan penyedia layanan lainnya.