fungsi lineGetID (tapi.h)

Artikel
03/02/2024

Fungsi lineGetID mengembalikan pengidentifikasi perangkat untuk kelas perangkat tertentu yang terkait dengan baris, alamat, atau panggilan yang dipilih.

Sintaks

LONG lineGetID(
  HLINE       hLine,
  DWORD       dwAddressID,
  HCALL       hCall,
  DWORD       dwSelect,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

Parameter

hLine

Menangani ke perangkat baris terbuka.

dwAddressID

Alamat pada perangkat baris terbuka yang diberikan. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi.

hCall

Menangani panggilan.

dwSelect

Menentukan apakah pengidentifikasi perangkat yang diminta dikaitkan dengan baris, alamat, atau satu panggilan. Parameter ini menggunakan satu dan hanya satu dari konstanta LINECALLSELECT_.

lpDeviceID

Penunjuk ke lokasi memori jenis VARSTRING, tempat pengidentifikasi perangkat dikembalikan. Setelah berhasil menyelesaikan permintaan, lokasi ini diisi dengan pengidentifikasi perangkat. Format informasi yang dikembalikan tergantung pada metode yang digunakan oleh API kelas perangkat untuk penamaan perangkat. Sebelum memanggil lineGetID, 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 .

lpszDeviceClass

Penunjuk ke string yang dihentikan null yang menentukan kelas perangkat perangkat yang pengidentifikasinya diminta. String kelas perangkat yang valid adalah string yang digunakan di bagian SYSTEM.INI untuk mengidentifikasi kelas perangkat.

Mengembalikan nilai

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

LINEERR_INVALLINEHANDLE, LINEERR_NOMEM, LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODEVICE, LINEERR_UNINITIALIZED.

Keterangan

Fungsi lineGetID dapat digunakan untuk mengambil pengidentifikasi perangkat baris saat diberikan handel baris. Ini berguna setelah lineOpen dibuka menggunakan LINEMAPPER sebagai pengidentifikasi perangkat untuk menentukan pengidentifikasi perangkat baris nyata dari baris yang dibuka. Fungsi ini juga dapat digunakan untuk mendapatkan pengidentifikasi perangkat perangkat telepon atau perangkat media (untuk kelas perangkat seperti COM, gelombang, MIDI, telepon, saluran, atau NDIS) yang terkait dengan panggilan, alamat, atau saluran. Pengidentifikasi ini kemudian dapat digunakan dengan API yang sesuai (seperti telepon, MIDI, gelombang) untuk memilih perangkat media terkait yang terkait dengan panggilan yang ditentukan.

Lihat Kelas Perangkat TAPI untuk nama kelas perangkat.

Vendor yang mendefinisikan mode media khusus perangkat juga perlu menentukan API khusus perangkat (kepemilikan) yang sesuai untuk mengelola perangkat mode media. Untuk menghindari tabrakan pada nama kelas perangkat yang ditetapkan secara independen oleh vendor yang berbeda, vendor harus memilih nama yang secara unik mengidentifikasi vendor dan, mengikutinya, jenis media. Misalnya: "intel/video".