Struktur LINECALLSTATUS (tapi.h)

  • Artikel

Struktur LINECALLSTATUS menjelaskan status panggilan saat ini. Informasi dalam struktur ini tergantung pada kemampuan perangkat alamat, kepemilikan panggilan oleh aplikasi pemanggilan, dan status panggilan saat ini yang dikueri. Fungsi lineGetCallStatus dan TSPI_lineGetCallStatus mengembalikan struktur LINECALLSTATUS .

Sintaks

typedef struct linecallstatus_tag {
  DWORD      dwTotalSize;
  DWORD      dwNeededSize;
  DWORD      dwUsedSize;
  DWORD      dwCallState;
  DWORD      dwCallStateMode;
  DWORD      dwCallPrivilege;
  DWORD      dwCallFeatures;
  DWORD      dwDevSpecificSize;
  DWORD      dwDevSpecificOffset;
  DWORD      dwCallFeatures2;
#if ...
  SYSTEMTIME tStateEntryTime;
#else
  WORD       tStateEntryTime[8];
#endif
} LINECALLSTATUS, *LPLINECALLSTATUS;

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.

dwCallState

Status panggilan panggilan saat ini menggunakan salah satu konstanta LINECALLSTATE_.

dwCallStateMode

Interpretasi anggota dwCallStateMode adalah call-state-dependent. Dalam banyak kasus, nilainya akan menjadi nol. Tabel berikut ini memperlihatkan jenis dwCallStateMode untuk nilai dwCallState tertentu.

dwCallState Makna
LINECALLSTATE_BUSY

Konstanta LINEBUSYMODE_
LINECALLSTATE_CONNECTED

Konstanta LINECONNECTEDMODE_
LINECALLSTATE_DIALTONE

Konstanta LINEDIALTONEMODE_
LINECALLSTATE_DISCONNECTED

Konstanta LINEDISCONNECTMODE_
LINECALLSTATE_OFFERING

Konstanta LINEOFFERINGMODE_
LINECALLSTATE_SPECIALINFO

Konstanta LINESPECIALINFO_

dwCallPrivilege

Hak istimewa aplikasi untuk panggilan ini. Anggota ini menggunakan satu atau beberapa konstanta LINECALLPRIVILEGE_.

dwCallFeatures

Bendera yang menunjukkan fungsi API Telepon yang dapat dipanggil pada panggilan, mengingat ketersediaan fitur dalam kemampuan perangkat, status panggilan saat ini, dan kepemilikan panggilan aplikasi yang dipanggil. Nol menunjukkan fitur yang sesuai tidak dapat dipanggil oleh aplikasi pada panggilan dalam statusnya saat ini; yang menunjukkan fitur dapat dipanggil. Anggota ini menggunakan konstanta LINECALLFEATURE_.

dwDevSpecificSize

Ukuran bidang khusus perangkat, dalam byte.

dwDevSpecificOffset

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

dwCallFeatures2

Menunjukkan fungsi tambahan dapat dipanggil pada panggilan, mengingat ketersediaan fitur dalam kemampuan perangkat, status panggilan saat ini, dan kepemilikan panggilan aplikasi pemanggilan. Ekstensi anggota dwCallFeatures . Anggota ini menggunakan konstanta LINECALLFEATURE2_.

tStateEntryTime

Waktu Universal Terkoordinasi di mana status panggilan saat ini dimasukkan.

tStateEntryTime[8]

Waktu Universal Terkoordinasi di mana status panggilan saat ini dimasukkan.

Keterangan

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

Aplikasi dikirimi pesan LINE_CALLSTATE setiap kali status panggilan panggilan berubah. Pesan ini hanya menyediakan status panggilan baru panggilan. Status tambahan tentang panggilan tersedia dengan lineGetCallStatus.

Anggota dwCallFeatures2 dan tStateEntryTime hanya tersedia untuk aplikasi yang membuka perangkat baris dengan versi API 2.0 atau yang lebih baru.

Persyaratan

Persyaratan Nilai
Header tapi.h

Lihat juga

LINEDIALPARAMS

LINE_CALLSTATE

TSPI_lineGetCallStatus

lineGetCallStatus