Struktur LINEDEVSTATUS (tapi.h)
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.
Persyaratan
Header | tapi.h |