Struktur LINEADDRESSCAPS (tapi.h)

Artikel
08/26/2023

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.