fungsi TSPI_lineGetID (tspi.h)

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

Sintaks

LONG TSPIAPI TSPI_lineGetID(
  HDRVLINE    hdLine,
  DWORD       dwAddressID,
  HDRVCALL    hdCall,
  DWORD       dwSelect,
  LPVARSTRING lpDeviceID,
  LPCWSTR     lpszDeviceClass,
  HANDLE      hTargetProcess
);

Parameter

hdLine

Handel penyedia layanan ke baris yang akan dikueri.

dwAddressID

Alamat pada perangkat baris terbuka yang diberikan. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi. TAPI tidak memvalidasi parameter ini ketika fungsi ini dipanggil.

hdCall

Handel penyedia layanan ke panggilan yang akan dikueri.

dwSelect

Menentukan apakah pengidentifikasi perangkat yang diminta dikaitkan dengan baris, alamat, atau satu panggilan. Parameter dwSelect hanya dapat memiliki salah satu 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 kelas perangkat (API) untuk penamaan perangkat.

lpszDeviceClass

Penunjuk ke string Unicode 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 (seperti COM, Wave, dan MCI.)

hTargetProcess

Handel proses aplikasi atas nama yang fungsi TSPI_lineGetID dipanggil. Jika informasi yang dikembalikan dalam struktur VARSTRING menyertakan handel untuk digunakan oleh aplikasi, penyedia layanan harus membuat atau menduplikasi handel untuk proses tersebut.

Jika hTargetProcess diatur ke INVALID_HANDLE_VALUE, maka aplikasi dijalankan pada sistem klien jarak jauh dan tidak dimungkinkan untuk membuat handel duplikat secara langsung. Sebaliknya, struktur VARSTRING harus berisi nama UNC perangkat jaringan atau nama lain yang dapat digunakan klien jarak jauh untuk mengakses perangkat. Jika ini tidak memungkinkan, maka fungsi harus gagal.

Nilai kembali

Mengembalikan nol jika fungsi berhasil, atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_INVALLINEHANDLE, LINEERR_NOMEM, LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NODEVICE, LINEERR_RESOURCEUNAVAIL.

Keterangan

Layanan menyediakan pengembalian LINEERR_INVALLINEHANDLE jika dwSelect LINECALLSELECT_LINE atau LINECALLSELECT_ADDRESS, dan hdLine tidak valid.

Penyedia layanan mengembalikan LINEERR_INVALCALLHANDLE jika dwSelect LINECALLSELECT_CALL dan hdCall tidak valid.

Penyedia layanan harus mendukung kelas perangkat tapi/baris untuk memungkinkan aplikasi menentukan pengidentifikasi perangkat baris nyata dari baris yang dibuka. Dalam hal ini, data variabel yang dikembalikan adalah dwDeviceID. Untuk informasi selengkapnya tentang nama kelas perangkat umum, lihat Kelas Perangkat TSPI.

Vendor yang mendefinisikan jenis media khusus perangkat juga perlu menentukan API khusus perangkat (kepemilikan) yang sesuai untuk mengelola perangkat jenis 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 kemudian jenis media; misalnya: "intel/video".

Penyedia layanan mengisi semua anggota struktur data VARSTRING , kecuali dwTotalSize, yang diisi oleh TAPI. Penyedia layanan tidak boleh menimpa anggota dwTotalSize .

Penyedia layanan tidak perlu khawatir dengan penanganan kelas perangkat tapi/line dan tapi/telepon karena TAPI menanganinya untuk penyedia layanan. Oleh karena itu, kode untuk menangani kelas perangkat ini bersifat opsional.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tspi.h

Lihat juga

TSPI_lineGetDevConfig

TSPI_lineSetDevConfig

VARSTRING