Struktur LINEADDRESSCAPS (tapi.h)
Struktur LINEADDRESSCAPS menjelaskan kemampuan alamat tertentu. Fungsi lineGetAddressCaps dan fungsi TSPI_lineGetAddressCaps mengembalikan struktur LINEADDRESSCAPS .
Sintaks
typedef struct lineaddresscaps_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwLineDeviceID;
DWORD dwAddressSize;
DWORD dwAddressOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwAddressSharing;
DWORD dwAddressStates;
DWORD dwCallInfoStates;
DWORD dwCallerIDFlags;
DWORD dwCalledIDFlags;
DWORD dwConnectedIDFlags;
DWORD dwRedirectionIDFlags;
DWORD dwRedirectingIDFlags;
DWORD dwCallStates;
DWORD dwDialToneModes;
DWORD dwBusyModes;
DWORD dwSpecialInfo;
DWORD dwDisconnectModes;
DWORD dwMaxNumActiveCalls;
DWORD dwMaxNumOnHoldCalls;
DWORD dwMaxNumOnHoldPendingCalls;
DWORD dwMaxNumConference;
DWORD dwMaxNumTransConf;
DWORD dwAddrCapFlags;
DWORD dwCallFeatures;
DWORD dwRemoveFromConfCaps;
DWORD dwRemoveFromConfState;
DWORD dwTransferModes;
DWORD dwParkModes;
DWORD dwForwardModes;
DWORD dwMaxForwardEntries;
DWORD dwMaxSpecificEntries;
DWORD dwMinFwdNumRings;
DWORD dwMaxFwdNumRings;
DWORD dwMaxCallCompletions;
DWORD dwCallCompletionConds;
DWORD dwCallCompletionModes;
DWORD dwNumCompletionMessages;
DWORD dwCompletionMsgTextEntrySize;
DWORD dwCompletionMsgTextSize;
DWORD dwCompletionMsgTextOffset;
DWORD dwAddressFeatures;
DWORD dwPredictiveAutoTransferStates;
DWORD dwNumCallTreatments;
DWORD dwCallTreatmentListSize;
DWORD dwCallTreatmentListOffset;
DWORD dwDeviceClassesSize;
DWORD dwDeviceClassesOffset;
DWORD dwMaxCallDataSize;
DWORD dwCallFeatures2;
DWORD dwMaxNoAnswerTimeout;
DWORD dwConnectedModes;
DWORD dwOfferingModes;
DWORD dwAvailableMediaModes;
} LINEADDRESSCAPS, *LPLINEADDRESSCAPS;
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.
dwLineDeviceID
Pengidentifikasi perangkat dari perangkat baris tempat alamat ini dikaitkan.
dwAddressSize
Ukuran bidang alamat, dalam byte.
dwAddressOffset
Offset dari awal struktur ke bidang alamat berukuran varian. Ukuran bidang ditentukan oleh dwAddressSize.
dwDevSpecificSize
Ukuran bidang khusus perangkat, dalam byte.
dwDevSpecificOffset
Offset dari awal struktur ke bidang khusus perangkat berukuran varian. Ukuran bidang ditentukan oleh dwDevSpecificSize.
dwAddressSharing
Mode berbagi alamat. Anggota ini bisa menjadi salah satu konstanta LINEADDRESSSHARING_.
dwAddressStates
Alamat menyatakan perubahan di mana aplikasi mungkin mendapatkan pemberitahuan dalam pesan LINE_ADDRESSSTATE. Anggota ini menggunakan satu atau beberapa konstanta LINEADDRESSSTATE_.
dwCallInfoStates
Panggil elemen informasi yang bermakna untuk semua panggilan di alamat ini. Aplikasi mungkin mendapatkan pemberitahuan tentang perubahan di beberapa status ini dalam pesan LINE_CALLINFO . Anggota ini menggunakan satu atau beberapa konstanta LINECALLINFOSTATE_.
dwCallerIDFlags
Jenis informasi pengidentifikasi pihak yang dapat disediakan untuk panggilan pada alamat ini. Penelepon adalah pencipta sesi. Satu atau beberapa konstanta LINECALLPARTYID_.
dwCalledIDFlags
Jenis informasi pengidentifikasi pihak yang dapat disediakan untuk panggilan pada alamat ini. Di sini, "dipanggil" mengacu pada tujuan asli. Satu atau beberapa konstanta LINECALLPARTYID_.
dwConnectedIDFlags
Jenis informasi pengidentifikasi pihak yang dapat disediakan untuk panggilan pada alamat ini. Satu atau beberapa konstanta LINECALLPARTYID_.
dwRedirectionIDFlags
Jenis informasi pengidentifikasi pihak yang dapat disediakan untuk panggilan pada alamat ini. Di sini, "pengalihan" adalah tujuan baru. Satu atau beberapa konstanta LINECALLPARTYID_.
dwRedirectingIDFlags
Jenis informasi pengidentifikasi pihak yang dapat disediakan untuk panggilan pada alamat ini. Di sini, "pengalihan" adalah alamat yang memanggil pengalihan. Satu atau beberapa konstanta LINECALLPARTYID_.
dwCallStates
Status panggilan yang dapat dilaporkan untuk panggilan pada alamat ini. Anggota ini menggunakan satu atau beberapa konstanta LINECALLSTATE_.
dwDialToneModes
Mode nada putar nomor yang dapat dilaporkan untuk panggilan yang dilakukan pada alamat ini. Anggota ini bermakna hanya jika status panggilan dialtone dapat dilaporkan. Anggota ini menggunakan satu atau beberapa konstanta LINEDIALTONEMODE_.
dwBusyModes
Mode sibuk yang dapat dilaporkan untuk panggilan yang dilakukan pada alamat ini. Anggota ini bermakna hanya jika status panggilan sibuk dapat dilaporkan. Anggota ini menggunakan satu atau beberapa konstanta LINEBUSYMODE_.
dwSpecialInfo
Jenis informasi khusus yang dapat dilaporkan untuk panggilan yang dilakukan pada alamat ini. Anggota ini bermakna hanya jika status panggilan specialInfo dapat dilaporkan. Anggota ini menggunakan satu atau beberapa konstanta LINESPECIALINFO_.
dwDisconnectModes
Mode putuskan sambungan yang dapat dilaporkan untuk panggilan yang dilakukan pada alamat ini. Anggota ini bermakna hanya jika status panggilan yang terputus dapat dilaporkan. Anggota ini menggunakan satu atau beberapa konstanta LINEDISCONNECTMODE_.
dwMaxNumActiveCalls
Jumlah maksimum tampilan panggilan aktif yang dapat ditangani alamat. Nomor ini tidak termasuk panggilan ditangguhkan atau panggilan pada transfer atau konferensi tertunda.
dwMaxNumOnHoldCalls
Jumlah maksimum penampilan panggilan di alamat yang dapat ditangguhkan.
dwMaxNumOnHoldPendingCalls
Jumlah maksimum penampilan panggilan di alamat yang dapat ditangguhkan transfer atau konferensi tertunda.
dwMaxNumConference
Jumlah maksimum pihak yang dapat bergabung dalam satu panggilan konferensi pada alamat ini.
dwMaxNumTransConf
Jumlah pihak (termasuk "self") yang dapat ditambahkan dalam panggilan konferensi yang dimulai sebagai panggilan konsultasi generik menggunakan lineSetupTransfer.
dwAddrCapFlags
Bendera bit kemasan yang menjelaskan berbagai kemampuan alamat. Anggota ini menggunakan satu atau beberapa konstanta LINEADDRCAPFLAGS_.
dwCallFeatures
Mengalihkan kemampuan atau fitur yang tersedia untuk semua panggilan pada alamat ini menggunakan LINECALLFEATURE_ Constants. Anggota ini mewakili fitur terkait panggilan yang mungkin tersedia di alamat (ketersediaan statis dibandingkan dengan ketersediaan dinamis). Memanggil fitur yang didukung mengharuskan panggilan berada dalam status yang tepat dan perangkat garis yang mendasar untuk dibuka dalam mode yang kompatibel. Nol dalam posisi bit menunjukkan bahwa fitur yang sesuai tidak pernah tersedia. Yang menunjukkan bahwa fitur yang sesuai mungkin tersedia jika aplikasi memiliki hak istimewa yang tepat untuk panggilan dan panggilan berada dalam status yang sesuai agar operasi bermakna. Anggota ini memungkinkan aplikasi untuk menemukan fitur panggilan mana yang dapat (dan yang tidak pernah dapat) didukung oleh alamat.
dwRemoveFromConfCaps
Kemampuan alamat untuk menghapus panggilan dari panggilan konferensi. Anggota ini menggunakan salah satu konstanta LINEREMOVEFROMCONF_.
dwRemoveFromConfState
Menggunakan konstanta LINECALLSTATE_ untuk menentukan status panggilan setelah dihapus dari panggilan konferensi.
dwTransferModes
Kemampuan alamat untuk menyelesaikan permintaan transfer. Anggota ini menggunakan salah satu konstanta LINETRANSFERMODE_.
dwParkModes
Mode taman panggilan yang berbeda tersedia di alamat ini. Anggota ini menggunakan salah satu konstanta LINEPARKMODE_.
dwForwardModes
Mode penerusan yang berbeda tersedia untuk alamat ini. Anggota ini menggunakan konstanta LINEFORWARDMODE_.
dwMaxForwardEntries
Jumlah maksimum entri yang dapat diteruskan ke lineForward dalam parameter lpForwardList .
dwMaxSpecificEntries
Jumlah maksimum entri dalam parameter lpForwardList yang diteruskan ke lineForward yang dapat berisi instruksi penerusan berdasarkan ID penelepon tertentu (pengalihan panggilan selektif). Anggota ini nol jika pengalihan panggilan selektif tidak didukung.
dwMinFwdNumRings
Jumlah minimum cincin yang dapat diatur untuk menentukan kapan panggilan secara resmi dianggap "tidak ada jawaban."
dwMaxFwdNumRings
Jumlah maksimum cincin yang dapat diatur untuk menentukan kapan panggilan secara resmi dianggap "tidak ada jawaban." Jika jumlah cincin ini tidak dapat diatur, maka dwMinFwdNumRings dan dwMaxNumRings sama.
dwMaxCallCompletions
Jumlah maksimum permintaan penyelesaian panggilan bersamaan yang dapat terutang pada perangkat baris ini. Nol menyiratkan bahwa penyelesaian panggilan tidak tersedia.
dwCallCompletionConds
Kondisi panggilan yang berbeda di mana penyelesaian panggilan dapat diminta. Anggota ini menggunakan satu atau beberapa konstanta LINECALLCOMPLCOND_.
dwCallCompletionModes
Cara panggilan dapat diselesaikan. Anggota ini menggunakan salah satu konstanta LINECALLCOMPLMODE_.
dwNumCompletionMessages
Jumlah pesan penyelesaian panggilan yang dapat dipilih saat menggunakan opsi LINECALLCOMPLMODE_MESSAGE. Pesan individual diidentifikasi oleh nilai dalam rentang nol hingga satu kurang dari dwNumCompletionMessages.
dwCompletionMsgTextEntrySize
Ukuran setiap deskripsi teks penyelesaian panggilan yang ditentukan oleh dwCompletionMsgTextSize dan dwCompletionMsgTextOffset, dalam byte.
dwCompletionMsgTextSize
Ukuran teks penyelesaian panggilan, dalam byte.
dwCompletionMsgTextOffset
Offset dari awal struktur data ini ke bidang berukuran varian yang berisi teks deskriptif tentang setiap pesan penyelesaian panggilan. Setiap pesan panjangnya adalah dwCompletionMsgTextEntrySize byte. Format string dari deskripsi tekstual ini ditunjukkan oleh dwStringFormat dalam kemampuan perangkat baris. Ukuran bidang ditentukan oleh dwCompletionMsgTextSize.
dwAddressFeatures
Fitur yang tersedia untuk alamat ini menggunakan konstanta LINEADDRFEATURE_. Memanggil fitur yang didukung mengharuskan alamat berada dalam status yang tepat dan perangkat garis yang mendasar untuk dibuka dalam mode yang kompatibel. Nol dalam posisi bit menunjukkan bahwa fitur yang sesuai tidak pernah tersedia. Yang menunjukkan bahwa fitur yang sesuai mungkin tersedia jika alamat berada dalam status yang sesuai agar operasi menjadi bermakna. Anggota ini memungkinkan aplikasi untuk menemukan fitur alamat mana yang dapat (dan yang tidak pernah dapat) didukung oleh alamat.
dwPredictiveAutoTransferStates
Status panggilan atau status di mana panggilan yang dilakukan oleh dialer prediktif dapat diatur untuk mentransfer panggilan secara otomatis ke alamat lain; satu atau beberapa konstanta LINECALLSTATE_. Nilai 0 menunjukkan transfer otomatis berdasarkan status panggilan tidak tersedia.
dwNumCallTreatments
Jumlah entri dalam array struktur LINECALLTREATMENTENTRY yang dibatasi oleh dwCallTreatmentListSize dan dwCallTreatmentListOffset.
dwCallTreatmentListSize
Ukuran array perawatan panggilan, dalam byte.
dwCallTreatmentListOffset
Offset dari awal struktur ke array struktur LINECALLTREATMENTENTRY menentukan perawatan panggilan yang didukung pada alamat (yang dapat dipilih menggunakan lineSetCallTreatment). Nilainya adalah dwNumCallTreatments kali SIZEOF(LINECALLTREATMENTENTRY). Ukuran bidang ditentukan oleh dwCallTreatmentListSize.
dwDeviceClassesSize
Ukuran daftar kelas perangkat yang didukung, dalam byte.
dwDeviceClassesOffset
Offset dari awal struktur ke string yang terdiri dari pengidentifikasi kelas perangkat yang didukung pada alamat ini untuk digunakan dengan lineGetID. Elemen dipisahkan oleh karakter null , dan pengidentifikasi kelas terakhir diikuti oleh dua karakter null . Ukuran bidang ditentukan oleh dwDeviceClassesSize.
dwMaxCallDataSize
Jumlah maksimum byte yang dapat diatur aplikasi di LINECALLINFO menggunakan lineSetCallData.
dwCallFeatures2
Kapabilitas atau fitur pengalihan tambahan yang tersedia untuk semua panggilan pada alamat ini menggunakan konstanta LINECALLFEATURE2_. Ini adalah ekstensi dari anggota dwCallFeatures .
dwMaxNoAnswerTimeout
Nilai maksimum dalam detik yang dapat diatur dalam anggota dwNoAnswerTimeout di LINECALLPARAMS saat melakukan panggilan. Nilai 0 menunjukkan bahwa pengabaian otomatis panggilan yang tidak terjawab tidak didukung oleh penyedia layanan, atau bahwa nilai batas waktu tidak dapat disesuaikan oleh aplikasi.
dwConnectedModes
LINECONNECTEDMODE_ nilai yang dapat muncul di anggota dwCallStateModelineCALLSTATUS dan dalam pesan LINE_CALLSTATE untuk panggilan di alamat ini.
dwOfferingModes
LINEOFFERINGMODE_ nilai yang dapat muncul di anggota dwCallStateModelineCALLSTATUS dan dalam pesan LINE_CALLSTATE untuk panggilan di alamat ini.
dwAvailableMediaModes
Jenis media (mode) yang dapat dipanggil pada panggilan baru yang dibuat pada alamat ini, ketika anggota dwAddressFeatures 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.
Keterangan
Ekstensi khusus perangkat harus menggunakan area berukuran devSpecific (dwDevSpecificSize dan dwDevSpecificOffset) dari struktur data ini.
Aplikasi lama dikompilasi tanpa anggota ini dalam struktur LINEADDRESSCAPS , dan menggunakan SIZEOF (LINEADDRESSCAPS) yang lebih kecil dari ukuran baru. Aplikasi lolos dalam parameter dwAPIVersion dengan fungsi lineGetAddressCaps , yang dapat digunakan untuk panduan oleh TAPI dalam menangani situasi ini. Jika aplikasi melewati anggota dwTotalSize kurang dari ukuran bagian tetap struktur seperti yang ditentukan dalam anggota dwAPIVersion yang ditentukan, LINEERR_STRUCTURETOOSMALL dikembalikan. Jika memori yang memadai telah dialokasikan oleh aplikasi, sebelum memanggil TSPI_lineGetAddressCaps, TAPI mengatur anggota dwNeedSize dan dwUsedSize ke ukuran tetap struktur seperti yang ada dalam versi API yang ditentukan.
Penyedia layanan baru (yang mendukung versi API baru) harus memeriksa versi API yang diteruskan. Jika versi API kurang dari versi tertinggi yang didukung oleh penyedia, penyedia layanan tidak boleh mengisi bidang yang tidak didukung dalam versi API yang lebih lama, karena ini akan termasuk dalam bagian variabel dari struktur yang lebih lama.
Aplikasi baru harus berkognizan dengan versi API yang dinegosiasikan, dan tidak memeriksa konten bidang dalam bagian tetap di luar akhir asli bagian tetap dari struktur untuk versi API yang dinegosiasikan.
Anggota dwPredictiveAutoTransferStates melalui dwAvailableMediaModes hanya tersedia untuk aplikasi yang meminta versi API 2.0 atau yang lebih baru saat memanggil lineGetAddressCaps.
Persyaratan
| Header | tapi.h |