fungsi TSPI_lineGetCallInfo (tspi.h)

  • Artikel

Fungsi TSPI_lineGetCallInfo mengembalikan informasi terperinci tentang panggilan yang ditentukan.

Sintaks

LONG TSPIAPI TSPI_lineGetCallInfo(
  HDRVCALL       hdCall,
  LPLINECALLINFO lpCallInfo
);

Parameter

hdCall

Pegangan penyedia layanan terhadap panggilan yang informasi panggilannya akan diambil. Status panggilan hdCall dapat menjadi status apa pun.

lpCallInfo

Penunjuk ke struktur data berukuran bervariasi dari jenis LINECALLINFO. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan informasi terkait panggilan.

Nilai kembali

Mengembalikan nol jika fungsi berhasil atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.

Keterangan

Tabel berikut menunjukkan anggota struktur data LINECALLINFO mana yang diisi oleh TAPI dan anggota mana yang diisi oleh penyedia layanan. Penyedia layanan harus mempertahankan (tidak boleh menimpa) nilai yang diisi oleh TAPI.

Nama anggota TAPI Penyedia layanan
dwTotalSize; X
dwNeededSize; X
dwUsedSize; X
hLine; X
dwLineDeviceID; X
dwAddressID; X
dwBearerMode; X
dwRate; X
dwMediaMode; X
dwAppSpecific; X
dwCallID; X
dwRelatedCallID; X
dwCallParamFlags; X
dwCallStates; X X
dwMonitorDigitModes; X
dwMonitorMediaModes; X
DialParams; X
dwOrigin; X
dwReason; X
dwCompletionID; X
dwNumOwners; X
dwNumMonitors; X
dwCountryCode; X
dwTrunk; X
dwCallerIDFlags; X
dwCallerIDSize; X
dwCallerIDOffset; X
dwCallerIDNameSize; X
dwCallerIDNameOffset; X
dwCalledIDFlags; X
dwCalledIDSize; X
dwCalledIDOffset; X
dwCalledIDNameSize; X
dwCalledIDNameOffset; X
dwConnectedIDFlags; X
dwConnectedIDSize; X
dwConnectedIDOffset; X
dwConnectedIDNameSize; X
dwConnectedIDNameOffset; X
dwRedirectionIDFlags; X
dwRedirectionIDSize; X
dwRedirectionIDOffset; X
dwRedirectionIDNameSize; X
dwRedirectionIDNameOffset; X
dwRedirectingIDFlags; X
dwRedirectingIDSize; X
dwRedirectingIDOffset; X
dwRedirectingIDNameSize; X
dwRedirectingIDNameOffset; X
dwAppNameSize; X
dwAppNameOffset; X
dwDisplayableAddressSize; X
dwDisplayableAddressOffset; X
dwCalledPartySize; X
dwCalledPartyOffset; X
dwCommentSize; X
dwCommentOffset; X
dwDisplaySize; X
dwDisplayOffset; X
dwUserUserInfoSize; X
dwUserUserInfoOffset; X
dwHighLevelCompSize; X
dwHighLevelCompOffset; X
dwLowLevelCompSize; X
dwLowLevelCompOffset; X
dwChargingInfoSize; X
dwChargingInfoOffset; X
dwTerminalModesSize; X
dwTerminalModesOffset; X
dwDevSpecificSize; X
dwDevSpecificOffset; X
 

TAPI mengisi bidang ukuran dan offset untuk dwAppNameSize/Offset, dwCalledPartySize/Offset, dan anggota dwCommentSize/Offset dan memperbarui nilai dalam dwUsedSize untuk mencerminkan hal ini setelah memanggil penyedia layanan.

Setelah penyedia layanan kembali dari fungsi TSPI_lineGetCallInfo , TAPI menetapkan anggota dwCallStates dari struktur LINECALLINFO sebagai berikut:

LINECALLINFO.dwCallStates |= LINECALLSTATE_UNKNOWN;

Jika penyedia layanan membuat model baris sebagai "kumpulan" sumber daya saluran dan melakukan multipleks terbalik dari panggilan melalui beberapa pengidentifikasi alamat, penyedia layanan harus secara konsisten memilih salah satu pengidentifikasi alamat ini sebagai pengidentifikasi utama yang dilaporkan oleh fungsi ini dalam struktur data LINECALLINFO .

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tspi.h