Struktur LINEDEVSTATUS (tapi.h)

Artikel
03/08/2023

Struktur LINEDEVSTATUS menjelaskan status perangkat baris saat ini. Fungsi lineGetLineDevStatus dan fungsi TSPI_lineGetLineDevStatus mengembalikan struktur LINEDEVSTATUS .

Sintaks

typedef struct linedevstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumOpens;
  DWORD dwOpenMediaModes;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwLineFeatures;
  DWORD dwNumCallCompletions;
  DWORD dwRingMode;
  DWORD dwSignalLevel;
  DWORD dwBatteryLevel;
  DWORD dwRoamMode;
  DWORD dwDevStatusFlags;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwAvailableMediaModes;
  DWORD dwAppInfoSize;
  DWORD dwAppInfoOffset;
} LINEDEVSTATUS, *LPLINEDEVSTATUS;

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.

dwNumOpens

Jumlah aktif yang terbuka pada perangkat baris.

dwOpenMediaModes

Array bit yang menunjukkan jenis media mana yang saat ini dibuka oleh perangkat baris.

dwNumActiveCalls

Jumlah panggilan pada baris dalam status panggilan selain diam, onhold, onholdpendingtransfer, dan onholdpendingconference.

dwNumOnHoldCalls

Jumlah panggilan pada baris dalam status onhold .

dwNumOnHoldPendCalls

Jumlah panggilan pada baris dalam status onholdpendingtransfer atau onholdpendingconference .

dwLineFeatures

Fungsi terkait baris yang saat ini tersedia pada baris ini. Anggota ini menggunakan satu atau beberapa konstanta LINEFEATURE_.

dwNumCallCompletions

Jumlah permintaan penyelesaian panggilan yang terutang pada baris.

dwRingMode

Mode dering saat ini pada perangkat baris.

dwSignalLevel

Tingkat sinyal koneksi saat ini pada baris. Ini adalah nilai dalam rentang 0x00000000 (sinyal terlemah) hingga 0x0000FFFF (sinyal terkuat).

dwBatteryLevel

Tingkat baterai perangkat keras perangkat baris saat ini. Ini adalah nilai dalam rentang 0x00000000 (baterai kosong) hingga 0x0000FFFF (baterai penuh).

dwRoamMode

Mode roaming perangkat garis saat ini. Anggota ini menggunakan salah satu konstanta LINEROAMMODE_.

dwDevStatusFlags

Bendera yang menunjukkan informasi status, seperti apakah perangkat dikunci. Ini terdiri dari satu atau beberapa anggota konstanta LINEDEVSTATUSFLAGS_.

dwTerminalModesSize

Ukuran bidang perangkat berukuran bervariasi yang berisi array mode terminal saat ini, dalam byte.

dwTerminalModesOffset

Offset dari awal struktur ke array mode terminal saat ini, dalam byte. Array ini diindeks oleh ID terminal, dalam rentang dari nol hingga dwNumTerminals dikurangi satu. Setiap entri dalam array menentukan mode terminal saat ini untuk set terminal yang sesuai menggunakan fungsi lineSetTerminal untuk baris ini. Setiap entri adalah DWORD yang menentukan satu atau beberapa konstanta LINETERMMODE_. Ukuran array ditentukan oleh dwTerminalModesSize.

dwDevSpecificSize

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

dwDevSpecificOffset

Offset dari awal struktur ke bidang khusus perangkat, dalam byte. Ukuran bidang ditentukan oleh dwDevSpecificSize.

dwAvailableMediaModes

Menunjukkan jenis media yang dapat dipanggil pada panggilan baru yang dibuat pada perangkat baris ini, ketika anggota dwLineFeatures menunjukkan bahwa panggilan baru dimungkinkan. Jika anggota ini nol, itu menunjukkan bahwa penyedia layanan tidak tahu atau tidak dapat menunjukkan jenis media mana yang tersedia, dalam hal ini salah satu atau semua jenis media yang ditunjukkan dalam anggota dwMediaModes di LINEDEVCAPS mungkin tersedia.

dwAppInfoSize

Ukuran array yang mengidentifikasi aplikasi yang membuka baris, dalam byte.

dwAppInfoOffset

Offset dari awal struktur ke array struktur LINEAPPINFO . Anggota dwNumOpens menunjukkan jumlah elemen dalam array. Setiap elemen dalam array mengidentifikasi aplikasi yang membuka baris. Ukuran array ditentukan oleh dwAppInfoSize.

Keterangan

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

Anggota dwAvailableMediaModes melalui dwAppInfoOffset hanya tersedia untuk aplikasi yang membuka perangkat baris dengan versi API 2.0 atau yang lebih baru.