fungsi phoneGetID (tapi.h)

Fungsi phoneGetID mengembalikan pengidentifikasi perangkat untuk kelas perangkat tertentu yang terkait dengan perangkat telepon yang ditentukan.

Sintaks

LONG phoneGetID(
  HPHONE      hPhone,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

Parameter

hPhone

Menangani ke perangkat telepon terbuka.

lpDeviceID

Penunjuk ke struktur data 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 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.

Nilai kembali

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL.

Keterangan

Fungsi phoneGetID dapat digunakan untuk mengambil pengidentifikasi perangkat telepon yang diberikan handel telepon. Ini juga dapat digunakan untuk mendapatkan pengidentifikasi perangkat perangkat media (untuk kelas perangkat seperti COM, gelombang, MIDI, telepon, saluran, atau NDIS) yang terkait dengan perangkat telepon yang dibuka. Nama kelas perangkat ini tidak peka huruf besar/kecil. Pengidentifikasi ini kemudian dapat digunakan dengan API media yang sesuai untuk memilih perangkat yang sesuai.

Lihat Kelas Perangkat TAPI untuk nama kelas perangkat.

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, mengikutinya, jenis media. Misalnya: "intel/video".

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tapi.h
Pustaka	Tapi32.lib
DLL	Tapi32.dll

Lihat juga

Fungsi Layanan Telepon Tambahan

Gambaran Umum Referensi TAPI 2.2

VARSTRING