Struktur PHONEBUTTONINFO (tapi.h)

Artikel
03/08/2023

Struktur PHONEBUTTONINFO berisi informasi tentang tombol di perangkat telepon. Struktur ini digunakan oleh beberapa fungsi TAPI dan TSPI.

Sintaks

typedef struct phonebuttoninfo_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwButtonMode;
  DWORD dwButtonFunction;
  DWORD dwButtonTextSize;
  DWORD dwButtonTextOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwButtonState;
} PHONEBUTTONINFO, *LPPHONEBUTTONINFO;

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.

dwButtonMode

Mode atau kelas penggunaan umum tombol. Anggota ini menggunakan salah satu konstanta PHONEBUTTONMODE_.

dwButtonFunction

Fungsi yang ditetapkan ke tombol . Anggota ini menggunakan salah satu konstanta PHONEBUTTONFUNCTION_.

dwButtonTextSize

Ukuran teks deskriptif untuk tombol, dalam byte.

dwButtonTextOffset

Offset dari awal struktur ini ke bidang berukuran varian yang berisi teks deskriptif untuk tombol ini. Format informasi ini seperti yang ditentukan dalam anggota dwStringFormat dari kemampuan perangkat ponsel. Ukuran bidang ditentukan oleh dwButtonTextSize.

dwDevSpecificSize

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

dwDevSpecificOffset

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

dwButtonState

Untuk fungsi phoneGetButtonInfo , bidang ini menunjukkan status tombol saat ini, menggunakan konstanta PHONEBUTTONSTATE_. Bidang ini diabaikan oleh fungsi phoneSetButtonInfo .

Keterangan

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

Aplikasi lama dikompilasi tanpa bidang ini dalam struktur PHONEBUTTONINFO , dan menggunakan SIZEOF PHONEBUTTONINFO yang lebih kecil dari ukuran baru. Aplikasi melewati parameter dwAPIVersion dengan fungsi phoneOpen , yang dapat digunakan untuk panduan oleh TAPI dalam menangani situasi ini. Jika aplikasi melewati dwTotalSize kurang dari ukuran bagian tetap struktur seperti yang didefinisikan dalam dwAPIVersion yang ditentukan, PHONEERR_STRUCTURETOOSMALL dikembalikan. Jika memori yang cukup telah dialokasikan oleh aplikasi, sebelum memanggil fungsi TSPI_phoneGetButtonInfo , TAPI mengatur anggota dwNeededSize dan dwUsedSize ke ukuran tetap struktur seperti yang ada dalam versi API yang ditentukan.

Penyedia layanan baru (yang mendukung versi API baru) harus memeriksa versi API yang diteruskan. Jika versi API kurang dari versi tertinggi yang didukung oleh penyedia, penyedia layanan tidak boleh mengisi bidang yang tidak didukung dalam versi API yang lebih lama, karena ini akan berada di bagian variabel dari struktur yang lebih lama.

Aplikasi baru harus kognizan dari versi API yang dinegosiasikan, dan tidak memeriksa konten bidang dalam bagian tetap di luar akhir asli bagian tetap struktur untuk versi API yang dinegosiasikan.