fungsi lineGetID (tapi.h)
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.
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".
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | tapi.h |
Pustaka | Tapi32.lib |
DLL | Tapi32.dll |
Lihat juga
Referensi Layanan Telepon Dasar