fungsi phoneGetDevCaps (tapi.h)
Fungsi phoneGetDevCaps meminta perangkat telepon tertentu untuk menentukan kemampuan teleponnya.
Sintaks
LONG phoneGetDevCaps(
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.
Menampilkan 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.
Persyaratan
Target Platform | Windows |
Header | tapi.h |
Pustaka | Tapi32.lib |
DLL | Tapi32.dll |
Lihat juga
Fungsi Layanan Telepon Tambahan
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk