Struktur LINEADDRESSSTATUS (tapi.h)

Artikel
08/26/2023

Struktur LINEADDRESSSTATUS menjelaskan status alamat saat ini. Fungsi lineGetAddressStatus dan fungsi TSPI_lineGetAddressStatus mengembalikan struktur LINEADDRESSSTATUS .

Sintaks

typedef struct lineaddressstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumInUse;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwAddressFeatures;
  DWORD dwNumRingsNoAnswer;
  DWORD dwForwardNumEntries;
  DWORD dwForwardSize;
  DWORD dwForwardOffset;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
} LINEADDRESSSTATUS, *LPLINEADDRESSSTATUS;

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.

dwNumInUse

Jumlah stasiun yang saat ini menggunakan alamat.

dwNumActiveCalls

Jumlah panggilan pada alamat yang berada dalam status panggilan selain diam, onhold, onholdpendingtransfer, dan onholdpendingconference.

dwNumOnHoldCalls

Jumlah panggilan pada alamat dalam status onhold .

dwNumOnHoldPendCalls

Jumlah panggilan pada alamat dalam status onholdpendingtransfer atau onholdpendingconference .

dwAddressFeatures

Fungsi terkait alamat yang dapat dipanggil pada alamat dalam statusnya saat ini. Anggota ini menggunakan satu atau beberapa konstanta LINEADDRFEATURE_.

dwNumRingsNoAnswer

Jumlah cincin yang ditetapkan untuk alamat ini sebelum panggilan yang tidak terjawab dianggap sebagai tidak ada jawaban.

dwForwardNumEntries

Jumlah entri dalam array yang disebut oleh dwForwardSize dan dwForwardOffset.

dwForwardSize

Ukuran array informasi penerusan, dalam byte.

dwForwardOffset

Offset dari awal struktur ke bidang berukuran bervariasi yang menjelaskan informasi penerusan alamat. Informasi ini adalah array elemen dwForwardNumEntries , dari jenis LINEFORWARD. Offset alamat dalam array relatif terhadap awal struktur LINEADDRESSSTATUS . Offset dwCallerAddressOffset dan dwDestAddressOffset di bidang berukuran bervariasi dari jenis LINEFORWARD yang diarahkan oleh dwForwardOffset relatif terhadap awal struktur data LINEADDRESSSTATUS (kontainer "root"). Ukuran array ditentukan oleh dwForwardSize.

dwTerminalModesSize

Ukuran array mode terminal, dalam byte.

dwTerminalModesOffset

Offset dari awal struktur ke bidang perangkat berukuran bervariasi yang berisi array dengan entri berukuran DWORD, yang menggunakan satu atau beberapa konstanta LINETERMMODE_. Array ini diindeks oleh pengidentifikasi terminal, dalam rentang dari nol hingga satu kurang dari dwNumTerminals. Setiap entri dalam array menentukan mode terminal saat ini untuk set terminal yang sesuai dengan fungsi lineSetTerminal untuk alamat ini. Ukuran array ditentukan oleh dwTerminalModesSize.

dwDevSpecificSize

Ukuran bidang khusus perangkat, dalam byte.

dwDevSpecificOffset

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

Keterangan

Ekstensi khusus perangkat harus menggunakan area berukuran devSpecific (dwDevSpecificSize dan dwDevSpecificOffset) dari struktur data ini.

Struktur data ini dikembalikan oleh fungsi lineGetAddressStatus . Ketika item dalam struktur data ini berubah sebagai konsekuensi dari aktivitas pada alamat, pesan LINE_ADDRESSSTATE dikirim ke aplikasi. Parameter untuk pesan ini adalah status alamat, salah satu konstanta LINEADDRESSSTATE_, yang menunjukkan bahwa item status dalam rekaman ini berubah.