Struktur PHONESTATUS (tapi.h)

Artikel
08/26/2023

Struktur PHONESTATUS menjelaskan status perangkat telepon saat ini. Fungsi phoneGetStatus dan TSPI_phoneGetStatus mengembalikan struktur ini.

Sintaks

typedef struct phonestatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwStatusFlags;
  DWORD dwNumOwners;
  DWORD dwNumMonitors;
  DWORD dwRingMode;
  DWORD dwRingVolume;
  DWORD dwHandsetHookSwitchMode;
  DWORD dwHandsetVolume;
  DWORD dwHandsetGain;
  DWORD dwSpeakerHookSwitchMode;
  DWORD dwSpeakerVolume;
  DWORD dwSpeakerGain;
  DWORD dwHeadsetHookSwitchMode;
  DWORD dwHeadsetVolume;
  DWORD dwHeadsetGain;
  DWORD dwDisplaySize;
  DWORD dwDisplayOffset;
  DWORD dwLampModesSize;
  DWORD dwLampModesOffset;
  DWORD dwOwnerNameSize;
  DWORD dwOwnerNameOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwPhoneFeatures;
} PHONESTATUS, *LPPHONESTATUS;

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.

dwStatusFlags

Bendera status untuk perangkat telepon ini. Anggota ini menggunakan salah satu konstanta PHONESTATUSFLAGS_.

dwNumOwners

Jumlah modul aplikasi dengan hak istimewa pemilik untuk telepon.

dwNumMonitors

Jumlah modul aplikasi dengan hak istimewa monitor untuk telepon.

dwRingMode

Mode dering perangkat telepon saat ini.

dwRingVolume

Volume dering perangkat telepon saat ini. Ini adalah nilai antara 0x00000000 (keheningan) dan 0x0000FFFF (volume maksimum).

dwHandsetHookSwitchMode

Mode switch hook saat ini dari handset ponsel. Anggota ini menggunakan salah satu konstanta PHONEHOOKSWITCHMODE_.

dwHandsetVolume

Volume speaker perangkat handset ponsel saat ini. Ini adalah nilai antara 0x00000000 (keheningan) dan 0x0000FFFF (volume maksimum).

dwHandsetGain

Perolehan mikrofon saat ini dari perangkat handset ponsel. Ini adalah nilai antara 0x00000000 (keheningan) dan 0x0000FFFF (perolehan maksimum).

dwSpeakerHookSwitchMode

Mode hookswitch saat ini dari speakerphone telepon. Anggota ini menggunakan salah satu konstanta PHONEHOOKSWITCHMODE_.

dwSpeakerVolume

Volume speaker perangkat speaker ponsel saat ini. Ini adalah nilai antara 0x00000000 (keheningan) dan 0x0000FFFF (volume maksimum).

dwSpeakerGain

Perolehan mikrofon saat ini dari perangkat speaker telepon. Ini adalah nilai antara 0x00000000 (keheningan) dan 0x0000FFFF (perolehan maksimum).

dwHeadsetHookSwitchMode

Mode hookswitch saat ini dari headset ponsel. Anggota ini menggunakan salah satu konstanta PHONEHOOKSWITCHMODE_.

dwHeadsetVolume

Volume speaker perangkat headset ponsel saat ini. Ini adalah nilai antara 0x00000000 (keheningan) dan 0x0000FFFF (volume maksimum).

dwHeadsetGain

Perolehan mikrofon saat ini dari perangkat headset ponsel. Ini adalah nilai antara 0x00000000 (keheningan) dan 0x0000FFFF (perolehan maksimum).

dwDisplaySize

Ukuran informasi tampilan, dalam byte.

dwDisplayOffset

Offset dari awal struktur ini ke bidang berukuran bervariasi yang berisi informasi tampilan ponsel saat ini. Ukuran bidang ditentukan oleh dwDisplaySize.

dwLampModesSize

Ukuran array mode lampu saat ini, dalam byte.

dwLampModesOffset

Offset dari awal struktur ini ke bidang berukuran bervariasi yang berisi mode lampu ponsel saat ini. Ukuran bidang ditentukan oleh dwLampModesSize.

dwOwnerNameSize

Ukuran nama pemilik saat ini, termasuk terminator null , dalam byte.

dwOwnerNameOffset

Offset dari awal struktur ke bidang berukuran bervariasi yang berisi nama aplikasi yang merupakan pemilik perangkat telepon saat ini. Namanya adalah nama aplikasi yang disediakan oleh aplikasi ketika dipanggil dengan phoneInitialize atau phoneInitializeEx. Jika tidak ada nama aplikasi yang disediakan, nama file aplikasi akan digunakan sebagai gantinya. Ukuran bidang ditentukan oleh dwOwnerNameSize. Jika ponsel saat ini tidak memiliki pemilik, dwOwnerNameSize adalah nol.

dwDevSpecificSize

Ukuran bidang khusus perangkat, dalam byte. Jika informasi khusus 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.

dwPhoneFeatures

Bendera yang menunjukkan fungsi API Telepon mana yang dapat dipanggil di ponsel, mempertimbangkan ketersediaan fitur dalam kemampuan perangkat, status perangkat saat ini, dan kepemilikan perangkat dari aplikasi pemanggilan. Nol menunjukkan fitur yang sesuai tidak dapat dipanggil oleh aplikasi pada ponsel dalam statusnya saat ini; yang menunjukkan fitur dapat dipanggil. Anggota ini menggunakan satu atau beberapa konstanta PHONEFEATURE_.