Struktur PHONECAPS (tapi.h)

Artikel
03/08/2023

Struktur PHONECAPS menjelaskan kemampuan perangkat telepon. Fungsi phoneGetDevCaps dan TSPI_phoneGetDevCaps mengembalikan struktur ini.

Sintaks

typedef struct phonecaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwProviderInfoSize;
  DWORD dwProviderInfoOffset;
  DWORD dwPhoneInfoSize;
  DWORD dwPhoneInfoOffset;
  DWORD dwPermanentPhoneID;
  DWORD dwPhoneNameSize;
  DWORD dwPhoneNameOffset;
  DWORD dwStringFormat;
  DWORD dwPhoneStates;
  DWORD dwHookSwitchDevs;
  DWORD dwHandsetHookSwitchModes;
  DWORD dwSpeakerHookSwitchModes;
  DWORD dwHeadsetHookSwitchModes;
  DWORD dwVolumeFlags;
  DWORD dwGainFlags;
  DWORD dwDisplayNumRows;
  DWORD dwDisplayNumColumns;
  DWORD dwNumRingModes;
  DWORD dwNumButtonLamps;
  DWORD dwButtonModesSize;
  DWORD dwButtonModesOffset;
  DWORD dwButtonFunctionsSize;
  DWORD dwButtonFunctionsOffset;
  DWORD dwLampModesSize;
  DWORD dwLampModesOffset;
  DWORD dwNumSetData;
  DWORD dwSetDataSize;
  DWORD dwSetDataOffset;
  DWORD dwNumGetData;
  DWORD dwGetDataSize;
  DWORD dwGetDataOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwDeviceClassesSize;
  DWORD dwDeviceClassesOffset;
  DWORD dwPhoneFeatures;
  DWORD dwSettableHandsetHookSwitchModes;
  DWORD dwSettableSpeakerHookSwitchModes;
  DWORD dwSettableHeadsetHookSwitchModes;
  DWORD dwMonitoredHandsetHookSwitchModes;
  DWORD dwMonitoredSpeakerHookSwitchModes;
  DWORD dwMonitoredHeadsetHookSwitchModes;
  GUID  PermanentPhoneGuid;
} PHONECAPS, *LPPHONECAPS;

Anggota

dwTotalSize

Ukuran total yang dialokasikan untuk struktur data ini, dalam byte.

dwNeededSize

Ukuran untuk struktur data ini yang diperlukan untuk menyimpan semua informasi yang dikembalikan, dalam byte.

dwUsedSize

Ukuran bagian dari struktur data ini yang berisi informasi yang berguna, dalam byte.

dwProviderInfoSize

Ukuran informasi khusus penyedia, dalam byte. Jika informasi khusus penyedia adalah penunjuk ke string, ukurannya harus menyertakan terminator null .

dwProviderInfoOffset

Offset dari awal struktur ke bidang berukuran bervariasi yang berisi informasi khusus penyedia layanan.

Anggota ini menyediakan informasi tentang perangkat keras dan/atau perangkat lunak penyedia, seperti nama vendor dan nomor versi perangkat keras dan perangkat lunak. Informasi ini dapat berguna ketika pengguna perlu memanggil layanan pelanggan dengan masalah mengenai penyedia. Ukuran bidang ditentukan oleh dwProviderInfoSize.

dwPhoneInfoSize

Ukuran informasi khusus telepon, dalam byte. Jika informasi khusus telepon adalah penunjuk ke string, ukurannya harus menyertakan terminator null .

dwPhoneInfoOffset

Offset dari awal struktur ke bidang perangkat berukuran bervariasi yang berisi informasi khusus telepon.

Anggota ini menyediakan informasi tentang perangkat telepon yang terpasang, seperti produsen perangkat telepon, nama model, versi perangkat lunak, dan sebagainya. Informasi ini dapat berguna ketika pengguna perlu memanggil layanan pelanggan dengan masalah terkait telepon. Ukuran bidang ditentukan oleh dwPhoneInfoSize.

dwPermanentPhoneID

Pengidentifikasi permanen tempat perangkat telepon diketahui dalam konfigurasi sistem.

dwPhoneNameSize

Ukuran nama yang dapat dikonfigurasi untuk telepon, termasuk terminator null , dalam byte.

dwPhoneNameOffset

Offset dari awal struktur ke bidang perangkat berukuran bervariasi yang berisi nama yang dapat dikonfigurasi pengguna untuk perangkat telepon ini. Nama ini dapat dikonfigurasi oleh pengguna saat mengonfigurasi penyedia layanan perangkat telepon dan disediakan untuk kenyamanan pengguna. Ukuran bidang ditentukan oleh dwPhoneNameSize.

dwStringFormat

Format string yang akan digunakan dengan perangkat telepon ini. Anggota ini menggunakan salah satu konstanta STRINGFORMAT_.

dwPhoneStates

Perubahan status untuk perangkat telepon ini di mana aplikasi dapat diberi tahu dalam pesan PHONE_STATE . Anggota ini satu atau beberapa konstanta PHONESTATE_.

dwHookSwitchDevs

Perangkat hookswitch telepon. Anggota ini menggunakan salah satu konstanta PHONEHOOKSWITCHDEV_.

dwHandsetHookSwitchModes

Mode hookswitch handset. Anggota hanya bermakna jika perangkat hookswitch tercantum di dwHookSwitchDevs. Ini menggunakan salah satu konstanta PHONEHOOKSWITCHMODE_.

dwSpeakerHookSwitchModes

Mode hookswitch speaker. Anggota hanya bermakna jika perangkat hookswitch tercantum di dwHookSwitchDevs. Ini menggunakan salah satu konstanta PHONEHOOKSWITCHMODE_.

dwHeadsetHookSwitchModes

Mode hookswitch headset. Anggota hanya bermakna jika perangkat hookswitch tercantum di dwHookSwitchDevs. Ini menggunakan salah satu konstanta PHONEHOOKSWITCHMODE_.

dwVolumeFlags

Kemampuan pengaturan volume komponen speaker perangkat telepon. Jika bit dalam posisi PHONEHOOKSWITCHDEV_ TRUE, volume komponen speaker perangkat hookswitch yang sesuai dapat disesuaikan dengan phoneSetVolume.

dwGainFlags

Kemampuan pengaturan keuntungan dari komponen mikrofon perangkat telepon. Jika posisi bit PHONEHOOKSWITCHDEV_ TRUE, volume komponen mikrofon perangkat hookswitch yang sesuai dapat disesuaikan dengan phoneSetGain.

dwDisplayNumRows

Tampilkan kapabilitas perangkat telepon dengan menjelaskan jumlah baris dalam tampilan telepon. Anggota dwDisplayNumRows dan dwDisplayNumColumns keduanya nol untuk perangkat telepon tanpa layar.

dwDisplayNumColumns

Tampilkan kapabilitas perangkat telepon dengan menjelaskan jumlah kolom dalam tampilan telepon. Anggota dwDisplayNumRows dan dwDisplayNumColumns keduanya nol untuk perangkat telepon tanpa layar.

dwNumRingModes

Kemampuan dering perangkat telepon. Ponsel dapat berdering dengan dwNumRingModes pola cincin yang berbeda, diidentifikasi sebagai 1, 2, melalui dwNumRingModes dikurangi satu. Jika nilai anggota ini adalah 0, aplikasi tidak memiliki kontrol atas mode dering telepon. Jika nilai anggota ini lebih besar dari 0, itu menunjukkan jumlah mode cincin selain keheningan yang didukung oleh penyedia layanan. Nilai 0 dalam parameter lpdwRingModedari phoneGetRing atau parameter dwRingModedari phoneSetRing menunjukkan keheningan (ponsel tidak berdering atau tidak boleh dibunyikan), dan nilai dwRingMode 1 hingga dwNumRingModes adalah mode dering yang valid untuk perangkat telepon.

dwNumButtonLamps

Jumlah tombol/lampu pada perangkat telepon yang dapat dideteksi di TAPI. Tombol/lampu diidentifikasi oleh pengidentifikasinya. Pengidentifikasi tombol/lampu yang valid berkisar dari nol hingga dwNumButtonLamps dikurangi satu. Tombol keypad '0', hingga '9', '*', dan '#' diberi pengidentifikasi 0 hingga 12.

dwButtonModesSize

Ukuran array mode tombol, dalam byte.

dwButtonModesOffset

Offset dari awal struktur ini ke bidang berukuran bervariasi yang berisi mode tombol tombol ponsel. Array diindeks oleh pengidentifikasi tombol/lampu. Array ini menggunakan konstanta PHONEBUTTONMODE_. Ukuran array ditentukan oleh dwButtonModesSize.

dwButtonFunctionsSize

Ukuran bidang fungsi tombol, dalam byte.

dwButtonFunctionsOffset

Offset dari awal struktur ini ke bidang berukuran bervariasi yang berisi fungsi tombol tombol ponsel. Array diindeks oleh pengidentifikasi tombol/lampu. Array ini menggunakan konstanta PHONEBUTTONFUNCTION_. Ukuran array ditentukan oleh dwButtonFunctionsSize.

dwLampModesSize

Ukuran array mode lampu, dalam byte.

dwLampModesOffset

Offset dari awal struktur ini ke bidang berukuran bervariasi yang berisi mode lampu lampu ponsel. Array diindeks oleh pengidentifikasi tombol/lampu. Array ini menggunakan konstanta PHONELAMPMODE_. Ukuran array ditentukan oleh dwLampModesSize.

dwNumSetData

Jumlah area unduhan yang berbeda di perangkat telepon. Area yang berbeda disebut menggunakan ID data 0, 1, , dwNumSetData dikurangi satu. Jika anggota ini nol, telepon tidak mendukung kemampuan unduhan.

dwSetDataSize

Ukuran array ukuran data, dalam byte.

dwSetDataOffset

Offset dari awal struktur ini ke bidang berukuran bervariasi yang berisi ukuran (dalam byte) area data unduhan ponsel. Ini adalah array dengan elemen berukuran DWORD yang diindeks oleh pengidentifikasi data. Ukuran array ditentukan oleh dwSetDataSize.

dwNumGetData

Jumlah area unggahan yang berbeda di perangkat telepon. Area yang berbeda disebut menggunakan ID data 0, 1, , dwNumGetData dikurangi satu. Jika bidang ini nol, telepon tidak mendukung kemampuan unggahan.

dwGetDataSize

Ukuran array ukuran data, dalam byte.

dwGetDataOffset

Offset dari awal struktur ini ke bidang berukuran bervariasi yang berisi ukuran (dalam byte) area unggah data ponsel. Ini adalah array dengan elemen berukuran DWORD yang diindeks oleh pengidentifikasi data. Ukuran array ditentukan oleh dwGetDataSize.

dwDevSpecificSize

Ukuran bidang khusus perangkat, dalam byte. Jika informasi spesifik perangkat adalah penunjuk ke string, ukurannya harus menyertakan terminator null .

dwDevSpecificOffset

Offset dari awal struktur ini ke bidang khusus perangkat berukuran bervariasi. Ukuran bidang ditentukan oleh dwDevSpecificSize.

dwDeviceClassesSize

Ukuran pengidentifikasi kelas perangkat yang didukung, dalam byte.

dwDeviceClassesOffset

Offset dari awal struktur ini ke string yang terdiri dari pengidentifikasi kelas perangkat yang didukung pada perangkat ini untuk digunakan dengan phoneGetID. Pengidentifikasi dipisahkan oleh NULLs, dan pengidentifikasi terakhir dalam daftar diikuti oleh dua NULLs. Ukuran bidang ditentukan oleh dwDeviceClassesSize.

dwPhoneFeatures

Bendera yang menunjukkan fungsi API Telepon mana yang dapat dipanggil di ponsel. Nol menunjukkan fitur yang sesuai tidak diimplementasikan dan tidak pernah dapat dipanggil oleh aplikasi di ponsel; yang menunjukkan fitur dapat dipanggil tergantung pada status perangkat dan faktor lainnya. Anggota ini menggunakan konstanta PHONEFEATURE_.

dwSettableHandsetHookSwitchModes

PHONEHOOKSWITCHMODE_ nilai yang dapat diatur pada handset menggunakan phoneSetHookSwitch.

dwSettableSpeakerHookSwitchModes

PHONEHOOKSWITCHMODE_ nilai yang dapat diatur di speakerphone menggunakan phoneSetHookSwitch.

dwSettableHeadsetHookSwitchModes

PHONEHOOKSWITCHMODE_ nilai yang dapat diatur pada headset menggunakan phoneSetHookSwitch.

dwMonitoredHandsetHookSwitchModes

PHONEHOOKSWITCHMODE_ nilai yang dapat dideteksi dan dilaporkan untuk handset dalam pesan PHONE_STATE dan melalui teleponGetHookSwitch.

dwMonitoredSpeakerHookSwitchModes

PHONEHOOKSWITCHMODE_ nilai yang dapat dideteksi dan dilaporkan untuk speakerphone dalam pesan PHONE_STATE dan melalui teleponSetHookSwitch.

dwMonitoredHeadsetHookSwitchModes

PHONEHOOKSWITCHMODE_ nilai yang dapat dideteksi dan dilaporkan untuk headset dalam pesan PHONE_STATE dan melalui teleponSetHookSwitch.

PermanentPhoneGuid

GUID yang secara permanen terkait dengan telepon ini.

Keterangan

Ekstensi khusus perangkat harus menggunakan area ukuran DevSpecific (dwDevSpecificSize dan dwDevSpecificOffset) dengan ukuran yang bervariasi dari struktur data ini.

Anggota dwDeviceClassesSize melalui dwMonitoredHeadsetHookSwitchModes hanya tersedia untuk aplikasi yang membuka perangkat telepon dengan versi API 2.0 atau yang lebih baru.