Struktur LINECALLINFO (tapi.h)
Struktur LINECALLINFO berisi informasi tentang panggilan. Informasi ini tetap relatif diperbaiki selama durasi panggilan. Beberapa fungsi menggunakan LINECALLINFO. Struktur dikembalikan oleh fungsi lineGetCallInfo dan fungsi TSPI_lineGetCallInfo . Jika bagian dari struktur berubah, maka pesan LINE_CALLINFO dikirim ke aplikasi yang menunjukkan item informasi mana yang telah berubah.
Mengubah informasi tentang panggilan secara dinamis, seperti status kemajuan panggilan, tersedia dalam struktur LINECALLSTATUS , dikembalikan oleh panggilan ke fungsi lineGetCallStatus .
Sintaks
typedef struct linecallinfo_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
HLINE hLine;
DWORD dwLineDeviceID;
DWORD dwAddressID;
DWORD dwBearerMode;
DWORD dwRate;
DWORD dwMediaMode;
DWORD dwAppSpecific;
DWORD dwCallID;
DWORD dwRelatedCallID;
DWORD dwCallParamFlags;
DWORD dwCallStates;
DWORD dwMonitorDigitModes;
DWORD dwMonitorMediaModes;
LINEDIALPARAMS DialParams;
DWORD dwOrigin;
DWORD dwReason;
DWORD dwCompletionID;
DWORD dwNumOwners;
DWORD dwNumMonitors;
DWORD dwCountryCode;
DWORD dwTrunk;
DWORD dwCallerIDFlags;
DWORD dwCallerIDSize;
DWORD dwCallerIDOffset;
DWORD dwCallerIDNameSize;
DWORD dwCallerIDNameOffset;
DWORD dwCalledIDFlags;
DWORD dwCalledIDSize;
DWORD dwCalledIDOffset;
DWORD dwCalledIDNameSize;
DWORD dwCalledIDNameOffset;
DWORD dwConnectedIDFlags;
DWORD dwConnectedIDSize;
DWORD dwConnectedIDOffset;
DWORD dwConnectedIDNameSize;
DWORD dwConnectedIDNameOffset;
DWORD dwRedirectionIDFlags;
DWORD dwRedirectionIDSize;
DWORD dwRedirectionIDOffset;
DWORD dwRedirectionIDNameSize;
DWORD dwRedirectionIDNameOffset;
DWORD dwRedirectingIDFlags;
DWORD dwRedirectingIDSize;
DWORD dwRedirectingIDOffset;
DWORD dwRedirectingIDNameSize;
DWORD dwRedirectingIDNameOffset;
DWORD dwAppNameSize;
DWORD dwAppNameOffset;
DWORD dwDisplayableAddressSize;
DWORD dwDisplayableAddressOffset;
DWORD dwCalledPartySize;
DWORD dwCalledPartyOffset;
DWORD dwCommentSize;
DWORD dwCommentOffset;
DWORD dwDisplaySize;
DWORD dwDisplayOffset;
DWORD dwUserUserInfoSize;
DWORD dwUserUserInfoOffset;
DWORD dwHighLevelCompSize;
DWORD dwHighLevelCompOffset;
DWORD dwLowLevelCompSize;
DWORD dwLowLevelCompOffset;
DWORD dwChargingInfoSize;
DWORD dwChargingInfoOffset;
DWORD dwTerminalModesSize;
DWORD dwTerminalModesOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwCallTreatment;
DWORD dwCallDataSize;
DWORD dwCallDataOffset;
DWORD dwSendingFlowspecSize;
DWORD dwSendingFlowspecOffset;
DWORD dwReceivingFlowspecSize;
DWORD dwReceivingFlowspecOffset;
DWORD dwCallerIDAddressType;
DWORD dwCalledIDAddressType;
DWORD dwConnectedIDAddressType;
DWORD dwRedirectionIDAddressType;
DWORD dwRedirectingIDAddressType;
} LINECALLINFO, *LPLINECALLINFO;
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.
hLine
Tangani ke perangkat baris tempat panggilan ini dikaitkan.
dwLineDeviceID
Pengidentifikasi perangkat dari perangkat baris tempat panggilan ini dikaitkan.
dwAddressID
Pengidentifikasi alamat pada baris tempat panggilan ini ada. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi.
dwBearerMode
Mode pembawa panggilan saat ini. Anggota ini menggunakan salah satu konstanta LINEBEARERMODE_.
dwRate
Laju aliran data panggilan, dalam bps (bit per detik).
dwMediaMode
Jenis media aliran informasi saat ini pada panggilan. Ini adalah jenis media seperti yang ditentukan oleh pemilik panggilan, yang belum tentu sama dengan pesan LINE_MONITORMEDIA terakhir. Anggota ini tidak terpengaruh secara langsung oleh pesan LINE_MONITORMEDIA. Anggota ini menggunakan konstanta LINEMEDIAMODE_.
dwAppSpecific
Tidak ditafsirkan oleh implementasi API dan penyedia layanan. Ini dapat diatur oleh setiap aplikasi pemilik panggilan ini dengan fungsi lineSetAppSpecific .
dwCallID
Di beberapa lingkungan telepon, pengalih atau penyedia layanan dapat menetapkan pengidentifikasi unik untuk setiap panggilan. Ini memungkinkan panggilan dilacak di seluruh transfer, penerusan, atau peristiwa lainnya. Domain ID panggilan ini dan cakupannya ditentukan penyedia layanan. Anggota dwCallID membuat pengidentifikasi unik ini tersedia untuk aplikasi.
dwRelatedCallID
Lingkungan telepon yang menggunakan ID panggilan sering kali mungkin merasa perlu untuk menghubungkan satu panggilan ke panggilan lain. Anggota dwRelatedCallID dapat digunakan oleh penyedia layanan untuk tujuan ini.
dwCallParamFlags
Kumpulan parameter terkait panggilan saat panggilan keluar. Ini adalah parameter panggilan yang sama yang ditentukan dalam lineMakeCall, satu atau beberapa konstanta LINECALLPARAMFLAGS_.
dwCallStates
Satu atau beberapa konstanta LINECALLSTATE_, yang menunjukkan status di mana aplikasi dapat diberi tahu pada panggilan ini. Anggota dwCallStates konstan di LINECALLINFO dan tidak berubah tergantung pada status panggilan.
dwMonitorDigitModes
Berbagai mode digit. Anggota ini adalah satu atau beberapa konstanta LINEDIGITMODE_, yang pemantauannya saat ini diaktifkan.
dwMonitorMediaModes
Berbagai jenis media yang pemantauannya saat ini diaktifkan. Anggota ini adalah satu atau beberapa konstanta LINEMEDIAMODE_.
DialParams
Parameter panggilan saat ini berlaku pada panggilan, jenis LINEDIALPARAMS. Kecuali parameter ini diatur oleh lineMakeCall atau lineSetCallParams, nilainya sama dengan default yang digunakan dalam struktur LINEDEVCAPS .
dwOrigin
Mengidentifikasi dari mana panggilan berasal. Anggota ini bisa menjadi salah satu konstanta LINECALLORIGIN_.
dwReason
Alasan mengapa panggilan terjadi. Anggota ini bisa menjadi salah satu konstanta LINECALLREASON_.
dwCompletionID
Pengidentifikasi penyelesaian untuk panggilan masuk jika merupakan hasil dari permintaan penyelesaian yang berakhir. Pengidentifikasi ini bermakna hanya jika dwReason LINECALLREASON_CALLCOMPLETION.
dwNumOwners
Jumlah modul aplikasi dengan handel panggilan yang berbeda dengan hak istimewa pemilik untuk panggilan.
dwNumMonitors
Jumlah modul aplikasi dengan handel panggilan yang berbeda dengan hak istimewa monitor untuk panggilan.
dwCountryCode
Kode negara atau wilayah pihak tujuan. Nol jika tidak diketahui.
dwTrunk
Jumlah batang tempat panggilan dirutekan. Anggota ini digunakan untuk panggilan masuk dan keluar. Anggota dwTrunk harus diatur ke 0xFFFFFFFF jika tidak diketahui.
dwCallerIDFlags
Menentukan validitas dan konten pemanggil, atau asal, informasi pengidentifikasi pihak. Anggota ini menggunakan salah satu konstanta LINECALLPARTYID_.
dwCallerIDSize
Ukuran nomor ID penelepon, dalam byte.
dwCallerIDOffset
Offset dari awal struktur ini ke bidang berukuran bervariasi yang berisi informasi nomor ID pihak pemanggil. Ukuran bidang ditentukan oleh dwCallerIDSize.
dwCallerIDNameSize
Ukuran nama ID penelepon termasuk terminator null, dalam byte.
dwCallerIDNameOffset
Offset dari awal struktur ini ke bidang berukuran bervariasi yang berisi informasi nama ID pihak pemanggil. Ukuran bidang ditentukan oleh dwCallerIDNameSize.
dwCalledIDFlags
Menentukan validitas dan konten informasi ID pihak yang disebut. Pihak yang dipanggil sesuai dengan pihak yang awalnya ditangani. Anggota ini menggunakan salah satu konstanta LINECALLPARTYID_.
dwCalledIDSize
Ukuran nomor ID pihak yang dipanggil, dalam byte.
dwCalledIDOffset
Offset dari awal struktur ke bidang berukuran bervariasi yang berisi informasi nomor ID pihak yang disebut. Ukuran bidang ditentukan oleh dwCalledIDSize.
dwCalledIDNameSize
Ukuran nama ID pihak yang dipanggil termasuk terminator null, dalam byte.
dwCalledIDNameOffset
Offset dari awal struktur ke bidang berukuran bervariasi yang berisi informasi nama ID pihak yang disebut. Ukuran bidang ditentukan oleh dwCalledIDNameSize.
dwConnectedIDFlags
Menentukan validitas dan konten informasi ID pihak yang terhubung. Pihak yang terhubung adalah pihak yang benar-benar terhubung dengan. Ini mungkin berbeda dari ID pihak yang disebut jika panggilan dialihkan. Anggota ini menggunakan salah satu konstanta LINECALLPARTYID_.
dwConnectedIDSize
Ukuran nomor ID pihak yang terhubung, dalam byte.
dwConnectedIDOffset
Offset dari awal struktur ini ke bidang berukuran bervariasi yang berisi informasi nomor ID pihak yang terhubung. Ukuran bidang ditentukan oleh dwConnectedIDSize.
dwConnectedIDNameSize
Ukuran nama ID pihak yang terhubung termasuk terminator null, dalam byte.
dwConnectedIDNameOffset
Offset dari awal struktur ini ke bidang berukuran bervariasi yang berisi informasi nama ID pihak yang terhubung. Ukuran bidang ditentukan oleh dwConnectedIDNameSize.
dwRedirectionIDFlags
Menentukan validitas dan konten informasi pengidentifikasi pihak pengalihan. Pihak pengalihan mengidentifikasi alamat tempat sesi dialihkan. Anggota ini menggunakan salah satu konstanta LINECALLPARTYID_.
dwRedirectionIDSize
Ukuran nomor ID pihak pengalihan, dalam byte.
dwRedirectionIDOffset
Offset dari awal struktur ke bidang berukuran bervariasi yang berisi informasi nomor ID pihak pengalihan. Ukuran bidang ditentukan oleh dwRedirectionIDSize.
dwRedirectionIDNameSize
Ukuran nama ID pihak pengalihan, dalam byte.
dwRedirectionIDNameOffset
Offset dari awal struktur ke bidang berukuran bervariasi yang berisi informasi nama ID pihak pengalihan. Ukuran bidang ditentukan oleh dwRedirectionIDNameSize.
dwRedirectingIDFlags
Menentukan validitas dan konten informasi pengidentifikasi pihak pengalihan. Pihak pengalihan mengidentifikasi alamat yang mengalihkan sesi. Anggota ini menggunakan salah satu konstanta LINECALLPARTYID_.
dwRedirectingIDSize
Ukuran nomor ID pihak pengalihan, dalam byte.
dwRedirectingIDOffset
Offset dari awal struktur ke bidang berukuran bervariasi yang berisi informasi nomor ID pihak pengalihan. Ukuran bidang ditentukan oleh dwRedirectingIDSize.
dwRedirectingIDNameSize
Ukuran nama ID pihak pengalihan termasuk terminator null, dalam byte.
dwRedirectingIDNameOffset
Offset dari awal struktur ke bidang berukuran varian yang berisi informasi nama ID pihak pengalihan. Ukuran bidang ditentukan oleh dwRedirectingIDNameSize.
dwAppNameSize
Ukuran bidang nama aplikasi termasuk terminator null, dalam byte.
dwAppNameOffset
Offset dari awal struktur ke bidang berukuran varian yang memegang nama aplikasi yang mudah digunakan yang pertama kali berasal, diterima, atau menjawab panggilan. Ini adalah nama yang dapat ditentukan aplikasi di lineInitializeEx. Jika aplikasi tidak menentukan nama tersebut, maka nama file modul aplikasi digunakan sebagai gantinya. Ukuran bidang ditentukan oleh dwAppNameSize.
dwDisplayableAddressSize
Ukuran string alamat yang dapat ditampilkan termasuk terminator null, dalam byte.
dwDisplayableAddressOffset
String yang dapat ditampilkan digunakan untuk tujuan pengelogan. Informasi diperoleh dari LINECALLPARAMS untuk fungsi yang memulai panggilan. Fungsi lineTranslateAddress mengembalikan informasi yang sesuai untuk ditempatkan di bidang ini di dwDisplayableAddressSize dan dwDisplayableAddressOffset anggota struktur LINETRANSLATEOUTPUT .
dwCalledPartySize
Ukuran bidang deskripsi pihak yang dipanggil, dalam byte.
dwCalledPartyOffset
Offset dari awal struktur ke bidang berukuran varians yang menentukan deskripsi yang mudah digunakan dari pihak yang dipanggil. Informasi ini dapat ditentukan dengan lineMakeCall dan dapat ditentukan secara opsional dalam parameter lpCallParams setiap kali panggilan baru dibuat. Ini berguna untuk tujuan pengelogan panggilan. Ukuran bidang ditentukan oleh dwCalledPartySize.
dwCommentSize
Ukuran bidang komentar, dalam byte.
dwCommentOffset
Offset dari awal struktur ke bidang berukuran varian yang memegang komentar tentang panggilan yang disediakan oleh aplikasi yang berasal dari panggilan menggunakan lineMakeCall. Informasi ini dapat ditentukan secara opsional dalam parameter lpCallParams setiap kali panggilan baru dibuat. Ukuran bidang ditentukan oleh dwCommentSize.
dwDisplaySize
Ukuran informasi tampilan mentah, dalam byte.
dwDisplayOffset
Offset dari awal struktur ke bidang berukuran varian yang menyimpan informasi tampilan mentah. Bergantung pada lingkungan telepon, penyedia layanan dapat mengekstrak informasi fungsional dari pasangan anggota ini untuk pemformatan dan presentasi yang paling sesuai untuk konfigurasi telepon ini. Ukuran bidang ditentukan oleh dwDisplaySize.
dwUserUserInfoSize
Ukuran informasi pengguna-pengguna, dalam byte. Jika informasi pengguna adalah penunjuk ke string, ukurannya harus menyertakan terminator null.
dwUserUserInfoOffset
Offset dari awal struktur ke bidang berukuran varian yang menyimpan informasi pengguna-pengguna. Bidang diskriminator protokol untuk informasi pengguna-pengguna, jika digunakan, muncul sebagai byte pertama data yang diarahkan oleh dwUserUserInfoOffset, dan diperkirakan dalam dwUserUserInfoSize.
dwHighLevelCompSize
Ukuran informasi kompatibilitas tingkat tinggi, dalam byte.
dwHighLevelCompOffset
Offset dari awal struktur ke bidang berukuran varian yang menyimpan informasi kompatibilitas tingkat tinggi. Format informasi ini ditentukan oleh standar lain (ISDN Q.931). Ukuran bidang ditentukan oleh dwHighLevelCompSize.
dwLowLevelCompSize
Ukuran informasi kompatibilitas tingkat rendah, dalam byte.
dwLowLevelCompOffset
Offset dari awal struktur ke bidang berukuran varian yang menyimpan informasi kompatibilitas tingkat rendah. Format informasi ini ditentukan oleh standar lain (ISDN Q.931). Ukuran bidang ditentukan oleh dwLowLevelCompSize.
dwChargingInfoSize
Ukuran informasi pengisian daya, dalam byte.
dwChargingInfoOffset
Offset dari awal struktur ke bidang berukuran varian yang menyimpan informasi pengisian daya. Format informasi ini ditentukan oleh standar lain (ISDN Q.931). Ukuran bidang ditentukan oleh dwChargingInfoSize.
dwTerminalModesSize
Ukuran array mode terminal saat ini, dalam byte.
dwTerminalModesOffset
Offset dari awal struktur ke bidang perangkat berukuran varian yang berisi array dengan entri berukuran DWORD. Entri array 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 aliran media panggilan ini, seperti yang ditentukan oleh salah satu konstanta LINETERMMODE_. Ukuran array ditentukan oleh dwTerminalModesSize.
dwDevSpecificSize
Ukuran bidang khusus perangkat, dalam byte.
dwDevSpecificOffset
Offset dari awal struktur ke bidang berukuran varian yang menyimpan informasi khusus perangkat. Ukuran bidang ditentukan oleh dwDevSpecificSize.
dwCallTreatment
Perawatan panggilan saat ini sedang diterapkan pada panggilan atau yang diterapkan ketika panggilan memasuki status berikutnya yang berlaku. Bisa nol jika perawatan panggilan tidak didukung.
dwCallDataSize
Ukuran data panggilan yang dapat diatur aplikasi, dalam byte.
dwCallDataOffset
Offset dari awal struktur ke data panggilan yang dapat diatur aplikasi. Ukuran bidang ditentukan oleh dwCallDataSize.
dwSendingFlowspecSize
Ukuran kualitas informasi layanan, dalam byte.
dwSendingFlowspecOffset
Offset dari awal struktur ke struktur FLOWSPEC diikuti oleh data khusus penyedia WinSock, setara dengan apa yang akan disimpan di SendingFlowspec dalam struktur QOS . Menentukan kualitas layanan yang saat ini berlaku dalam arah pengiriman pada panggilan. Bagian khusus penyedia yang mengikuti struktur FLOWSPEC tidak boleh berisi pointer ke blok memori lain, karena TAPI tidak tahu cara membasmi data yang diarahkan oleh pointer privat dan menyampaikannya melalui komunikasi antarproses ke aplikasi. Ukuran bidang ditentukan oleh dwSendingFlowspecSize.
dwReceivingFlowspecSize
Ukuran kualitas informasi layanan, dalam byte.
dwReceivingFlowspecOffset
Offset dari awal struktur ke struktur FLOWSPEC diikuti oleh data khusus penyedia WinSock, setara dengan apa yang akan disimpan di ReceivingFlowspec dalam struktur QOS . Menentukan kualitas layanan yang saat ini berlaku dalam arah penerimaan pada panggilan. Bagian khusus penyedia yang mengikuti struktur FLOWSPEC tidak boleh berisi pointer ke blok memori lain, karena TAPI tidak tahu cara membasmi data yang diarahkan oleh pointer privat dan menyampaikannya melalui komunikasi antarproses ke aplikasi. Ukuran bidang ditentukan oleh dwReceivingFlowspecSize.
dwCallerIDAddressType
Jenis alamat penelepon. Anggota struktur ini hanya tersedia jika versi TAPI yang dinegosiasikan adalah 3.0 atau lebih tinggi.
dwCalledIDAddressType
Jenis alamat pihak yang dipanggil. Anggota struktur ini hanya tersedia jika versi TAPI yang dinegosiasikan adalah 3.0 atau lebih tinggi.
dwConnectedIDAddressType
Jenis alamat tujuan tempat panggilan benar-benar tersambung. Anggota struktur ini hanya tersedia jika versi TAPI yang dinegosiasikan adalah 3.0 atau lebih tinggi.
dwRedirectionIDAddressType
Jenis alamat tujuan panggilan baru. Anggota struktur ini hanya tersedia jika versi TAPI yang dinegosiasikan adalah 3.0 atau lebih tinggi.
dwRedirectingIDAddressType
Jenis alamat lokasi yang mengalihkan panggilan. Anggota struktur ini hanya tersedia jika versi TAPI yang dinegosiasikan adalah 3.0 atau lebih tinggi.
Keterangan
Ekstensi khusus perangkat harus menggunakan area ukuran DevSpecific (dwDevSpecificSize dan dwDevSpecificOffset) dengan ukuran yang bervariasi dari struktur data ini.
Struktur data LINECALLINFO berisi informasi yang relatif tetap tentang panggilan. Struktur ini dikembalikan dengan lineGetCallInfo. Ketika item informasi dalam struktur data ini telah berubah, pesan LINE_CALLINFO dikirim ke aplikasi. Parameter untuk pesan ini adalah item informasi atau bidang yang berubah.
Anggota dwCallTreatment melalui dwReceivingFlowspecOffset hanya tersedia untuk aplikasi yang membuka perangkat baris dengan versi API 2.0 atau yang lebih baru.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | tapi.h |