fungsi lineGetDevCaps (tapi.h)

Artikel
03/02/2024

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.

Catatan Jika parameter ukuran dalam struktur tidak benar, ada kemungkinan data bisa ditimpa. Untuk informasi selengkapnya tentang pengaturan ukuran struktur, lihat topik alokasi memori .

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.