fungsi lineGetDevCaps (tapi.h)
Fungsi lineGetDevCaps meminta perangkat baris tertentu untuk menentukan kemampuan teleponnya. Informasi yang dikembalikan valid untuk semua alamat pada perangkat baris.
Sintaks
LONG lineGetDevCaps(
HLINEAPP hLineApp,
DWORD dwDeviceID,
DWORD dwAPIVersion,
DWORD dwExtVersion,
LPLINEDEVCAPS lpLineDevCaps
);
Parameter
hLineApp
Tangani pendaftaran aplikasi dengan TAPI.
dwDeviceID
Pengidentifikasi perangkat baris 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. Jumlah ini diperoleh oleh lineNegotiateAPIVersion.
dwExtVersion
Nomor versi ekstensi khusus penyedia layanan yang akan digunakan. Jumlah ini diperoleh oleh lineNegotiateExtVersion. 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.
lpLineDevCaps
Penunjuk ke struktur tipe LINEDEVCAPS yang bervariasi. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan informasi kemampuan perangkat baris. Sebelum memanggil lineGetDevCaps, aplikasi harus mengatur anggota dwTotalSize dari struktur ini untuk menunjukkan jumlah memori yang tersedia untuk TAPI untuk mengembalikan informasi.
Mengembalikan nilai
Mengembalikan nol jika permintaan berhasil atau nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:
LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALAPPHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.
Keterangan
Sebelum menggunakan lineGetDevCaps, aplikasi harus menegosiasikan nomor versi API untuk digunakan, dan, jika diinginkan, versi ekstensi yang akan digunakan.
API dan nomor versi ekstensi adalah nomor di mana TAPI dan penyedia layanan harus beroperasi. Jika rentang versi tidak tumpang tindih, versi aplikasi, API, atau penyedia layanan tidak kompatibel dan kesalahan dikembalikan.
Salah satu anggota dalam struktur LINEDEVCAPS yang dikembalikan oleh fungsi ini berisi jumlah alamat yang ditetapkan ke perangkat baris yang ditentukan. Pengidentifikasi alamat aktual yang digunakan untuk mereferensikan alamat individual bervariasi dari nol hingga satu kurang dari angka yang dikembalikan. Kemampuan setiap alamat bisa berbeda. Gunakan lineGetAddressCaps untuk setiap kombinasi dwDeviceID, dwAddressID> yang tersedia < untuk menentukan kemampuan yang tepat dari setiap alamat. Perhatikan bahwa pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | tapi.h |
Pustaka | Tapi32.lib |
DLL | Tapi32.dll |
Lihat juga
Referensi Layanan Telepon Dasar