fungsi phoneGetDevCapsA (tapi.h)

Artikel
03/08/2023

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 urutan tinggi berisi nomor versi utama; kata urutan 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 urutan 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 nomor 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, aplikasi dan API atau versi 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 pra-prosesor 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.