fungsi phoneGetDevCapsA (tapi.h)

Artikel
03/08/2023
2 menit untuk membaca

Fungsi phoneGetDevCaps meminta perangkat telepon tertentu untuk menentukan kemampuan teleponnya.

Sintaks

LONG phoneGetDevCapsA(
  HPHONEAPP   hPhoneApp,
  DWORD       dwDeviceID,
  DWORD       dwAPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

Parameter

hPhoneApp

Tangani pendaftaran aplikasi dengan TAPI.

dwDeviceID

Pengidentifikasi perangkat telepon yang akan dikueri.

dwAPIVersion

Nomor versi API Telepon yang akan digunakan. Kata berurutan tinggi berisi nomor versi utama; kata berurutan rendah berisi nomor versi minor. Nomor ini diperoleh dengan fungsi phoneNegotiateAPIVersion.

dwExtVersion

Nomor versi ekstensi khusus penyedia layanan yang akan digunakan. Nomor ini diperoleh dengan fungsi phoneNegotiateExtVersion. Ini dapat dibiarkan nol jika tidak ada ekstensi khusus perangkat yang akan digunakan. Jika tidak, kata urutan tinggi berisi nomor versi utama; kata berurutan rendah berisi nomor versi minor.

lpPhoneCaps

Penunjuk ke struktur jenis PHONECAPS yang bervariasi. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan informasi kemampuan perangkat telepon.

Mengembalikan nilai

Mengembalikan nol jika permintaan berhasil atau angka kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

PHONEERR_INVALAPPHANDLE, PHONEERR_INVALPOINTER, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONFAILED, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_NOMEM, PHONEERR_STRUCTURETOOSMALL, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Keterangan

Sebelum menggunakan phoneGetDevCaps, aplikasi harus menegosiasikan nomor versi TAPI untuk digunakan (lihat phoneNegotiateAPIVersion) dan, secara opsional, versi ekstensi yang akan digunakan (lihat phoneNegotiateExtVersion).

TAPI dan nomor versi ekstensi adalah nomor di mana TAPI, Telephony DLL, dan penyedia layanan harus beroperasi. Jika rentang versi tidak tumpang tindih, versi aplikasi dan API atau penyedia layanan tidak kompatibel dan kesalahan dikembalikan.

Catatan

Header tapi.h mendefinisikan phoneGetDevCaps sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.