Condividi tramite


Struttura LINECALLINFO (tapi.h)

La struttura LINECALLINFO contiene informazioni su una chiamata. Queste informazioni rimangono relativamente fisse per la durata della chiamata. Più funzioni usano LINECALLINFO. La struttura viene restituita dalla funzione lineGetCallInfo e dalla funzione TSPI_lineGetCallInfo . Se una parte della struttura viene modificata, all'applicazione viene inviato un messaggio di LINE_CALLINFO che indica quale elemento informativo è stato modificato.

Le informazioni che cambiano dinamicamente su una chiamata, ad esempio lo stato di avanzamento delle chiamate, sono disponibili nella struttura LINECALLSTATUS , restituite da una chiamata alla funzione lineGetCallStatus .

Sintassi

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;

Members

dwTotalSize

Dimensioni totali allocate a questa struttura di dati, in byte.

dwNeededSize

Dimensioni per questa struttura di dati necessaria per contenere tutte le informazioni restituite, in byte.

dwUsedSize

Dimensioni della parte di questa struttura di dati che contiene informazioni utili, in byte.

hLine

Handle per il dispositivo linea a cui è associata questa chiamata.

dwLineDeviceID

Identificatore del dispositivo della riga a cui è associata questa chiamata.

dwAddressID

Identificatore di indirizzo dell'indirizzo nella riga in cui è presente questa chiamata. Un identificatore di indirizzo è associato in modo permanente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

dwBearerMode

Modalità di connessione corrente della chiamata. Questo membro utilizza una delle costanti LINEBEARERMODE_.

dwRate

Frequenza del flusso di dati della chiamata, in bps (bit al secondo).

dwMediaMode

Tipo di supporto del flusso di informazioni attualmente nella chiamata. Si tratta del tipo di supporto determinato dal proprietario della chiamata, che non è necessariamente uguale a quello dell'ultimo messaggio LINE_MONITORMEDIA . Questo membro non è interessato direttamente dai messaggi LINE_MONITORMEDIA. Questo membro utilizza le costanti LINEMEDIAMODE_.

dwAppSpecific

Non interpretato dall'implementazione dell'API e dal provider di servizi. Può essere impostato da qualsiasi applicazione proprietaria di questa chiamata con la funzione lineSetAppSpecific .

dwCallID

In alcuni ambienti di telefonia, il commutatore o il provider di servizi può assegnare un identificatore univoco a ogni chiamata. Ciò consente di tenere traccia della chiamata tra trasferimenti, inoltro o altri eventi. Il dominio di questi ID chiamata e il relativo ambito è definito dal provider di servizi. Il membro dwCallID rende questo identificatore univoco disponibile per le applicazioni.

dwRelatedCallID

Gli ambienti di telefonia che usano l'ID chiamata spesso possono trovare la necessità di correlare una chiamata a un'altra. A questo scopo, il membro dwRelatedCallID può essere utilizzato dal provider di servizi.

dwCallParamFlags

Raccolta di parametri correlati alla chiamata quando la chiamata è in uscita. Si tratta degli stessi parametri di chiamata specificati in lineMakeCall, una o più costanti LINECALLPARAMFLAGS_.

dwCallStates

Una o più costanti LINECALLSTATE_ che indicano gli stati in cui l'applicazione può ricevere una notifica su questa chiamata. Il membro dwCallStates è costante in LINECALLINFO e non cambia a seconda dello stato della chiamata.

dwMonitorDigitModes

Varie modalità di cifra. Questo membro è una o più costanti LINEDIGITMODE_, per cui il monitoraggio è attualmente abilitato.

dwMonitorMediaModes

Vari tipi di supporti per cui il monitoraggio è attualmente abilitato. Questo membro è una o più costanti LINEMEDIAMODE_.

DialParams

Composizione dei parametri attualmente in vigore sulla chiamata, di tipo LINEDIALPARAMS. A meno che questi parametri non siano impostati da lineMakeCall o lineSetCallParams, i relativi valori corrispondono ai valori predefiniti usati nella struttura LINEDEVCAPS .

dwOrigin

Identifica la posizione in cui ha avuto origine la chiamata. Questo membro può essere una delle costanti LINECALLORIGIN_.

dwReason

Motivo per cui si è verificata la chiamata. Questo membro può essere una delle costanti LINECALLREASON_.

dwCompletionID

Identificatore di completamento per la chiamata in ingresso se è il risultato di una richiesta di completamento che termina. Questo identificatore è significativo solo se dwReason è LINECALLREASON_CALLCOMPLETION.

dwNumOwners

Numero di moduli dell'applicazione con handle di chiamata diversi con privilegi di proprietario per la chiamata.

dwNumMonitors

Numero di moduli dell'applicazione con handle di chiamata diversi con privilegi di monitoraggio per la chiamata.

dwCountryCode

Codice paese o area geografica dell'entità di destinazione. Zero se sconosciuto.

dwTrunk

Numero del trunk su cui viene instradata la chiamata. Questo membro viene usato sia per le chiamate in ingresso che in uscita. Il membro dwTrunk deve essere impostato su 0xFFFFFFFF se è sconosciuto.

dwCallerIDFlags

Determina la validità e il contenuto del chiamante o dell'originatore, informazioni sull'identificatore di entità. Questo membro utilizza una delle costanti LINECALLPARTYID_.

dwCallerIDSize

Dimensioni del numero ID del chiamante, in byte.

dwCallerIDOffset

Offset dall'inizio di questa struttura al campo di dimensioni variabile contenente le informazioni sul numero ID del chiamante. Le dimensioni del campo sono specificate da dwCallerIDSize.

dwCallerIDNameSize

Dimensioni del nome ID chiamante, incluso il carattere di terminazione Null, in byte.

dwCallerIDNameOffset

Offset dall'inizio di questa struttura al campo di dimensioni variabile contenente le informazioni sul nome DELL'ID del chiamante. Le dimensioni del campo sono specificate da dwCallerIDNameSize.

dwCalledIDFlags

Determina la validità e il contenuto delle informazioni sull'ID chiamato. La parte chiamata corrisponde alla parte originariamente indirizzata. Questo membro utilizza una delle costanti LINECALLPARTYID_.

dwCalledIDSize

Dimensione in byte del numero ID chiamato-party.

dwCalledIDOffset

Offset dall'inizio della struttura al campo di dimensioni variabile contenente le informazioni sul numero ID chiamato.Offset from the beginning of the structure to the variably size field containing the called-party ID number information. Le dimensioni del campo vengono specificate da dwCalledIDSize.

dwCalledIDNameSize

Dimensioni del nome ID chiamato-party, incluso il carattere di terminazione Null, in byte.

dwCalledIDNameOffset

Offset dall'inizio della struttura al campo di dimensioni variabile contenente le informazioni sul nome DELL'ID chiamato.Offset from the beginning of the structure to the variably size field containing the called-party ID name information. Le dimensioni del campo vengono specificate da dwCalledIDNameSize.

dwConnectedIDFlags

Determina la validità e il contenuto delle informazioni sull'ID dell'entità connessa. La parte connessa è la parte effettivamente connessa. Questo può essere diverso dall'ID chiamato-party se la chiamata è stata deviata. Questo membro utilizza una delle costanti LINECALLPARTYID_.

dwConnectedIDSize

Dimensione in byte del numero ID dell'entità connessa.

dwConnectedIDOffset

Offset dall'inizio di questa struttura al campo di dimensioni variabile contenente le informazioni sul numero ID dell'entità connessa. Le dimensioni del campo vengono specificate da dwConnectedIDSize.

dwConnectedIDNameSize

Dimensioni del nome ID dell'entità connessa, incluso il carattere di terminazione Null, in byte.

dwConnectedIDNameOffset

Offset dall'inizio di questa struttura al campo di dimensioni variabile contenente le informazioni sul nome ID dell'entità connessa. Le dimensioni del campo vengono specificate da dwConnectedIDNameSize.

dwRedirectionIDFlags

Determina la validità e il contenuto delle informazioni sull'identificatore di entità di reindirizzamento. La parte di reindirizzamento identifica l'indirizzo a cui è stata reindirizzata la sessione. Questo membro utilizza una delle costanti LINECALLPARTYID_.

dwRedirectionIDSize

Dimensione in byte del numero ID dell'entità di reindirizzamento.

dwRedirectionIDOffset

Offset dall'inizio della struttura al campo di dimensioni variabile contenente le informazioni sul numero ID di entità di reindirizzamento. Le dimensioni del campo sono specificate da dwRedirectionIDSize.

dwRedirectionIDNameSize

Dimensioni del nome ID di entità di reindirizzamento, in byte.

dwRedirectionIDNameOffset

Offset dall'inizio della struttura al campo di dimensioni variabile contenente le informazioni sul nome ID di entità di reindirizzamento. Le dimensioni del campo sono specificate da dwRedirectionIDNameSize.

dwRedirectingIDFlags

Determina la validità e il contenuto delle informazioni sull'identificatore di entità di reindirizzamento. La parte di reindirizzamento identifica l'indirizzo che reindirizza la sessione. Questo membro utilizza una delle costanti LINECALLPARTYID_.

dwRedirectingIDSize

Dimensioni del numero ID di entità di reindirizzamento, in byte.

dwRedirectingIDOffset

Offset dall'inizio della struttura al campo di dimensioni variabile contenente le informazioni sul numero ID di entità di reindirizzamento. Le dimensioni del campo sono specificate da dwRedirectingIDSize.

dwRedirectingIDNameSize

Dimensioni del nome ID di entità di reindirizzamento, incluso il carattere di terminazione Null, in byte.

dwRedirectingIDNameOffset

Offset dall'inizio della struttura al campo di dimensioni variabile contenente le informazioni sul nome ID di reindirizzamento. Le dimensioni del campo sono specificate da dwRedirectingIDNameSize.

dwAppNameSize

Dimensioni del campo nome applicazione, incluso il terminatore Null, in byte.

dwAppNameOffset

Offset dall'inizio della struttura al campo di dimensioni variabile che contiene il nome descrittivo dell'applicazione che ha avuto origine, accettato o risposto alla chiamata. Si tratta del nome che un'applicazione può specificare in lineInitializeEx. Se l'applicazione non specifica alcun nome di questo tipo, viene invece usato il nome del modulo dell'applicazione. Le dimensioni del campo sono specificate da dwAppNameSize.

dwDisplayableAddressSize

Dimensioni della stringa di indirizzo visualizzabile, tra cui il terminatore Null, in byte.

dwDisplayableAddressOffset

La stringa visualizzabile viene usata per scopi di registrazione. Le informazioni vengono ottenute da LINECALLPARAMS per le funzioni che avviano le chiamate. La funzione lineTranslateAddress restituisce informazioni appropriate da inserire in questo campo nella struttura dwDisplayableAddressSize e dwDisplayableAddressOffset della struttura LINETRANSLATEOUTPUT.

dwCalledPartySize

Dimensioni del campo descrizione della descrizione di chiamato parti, in byte.

dwCalledPartyOffset

Offset dall'inizio della struttura al campo di dimensioni variabile che specifica la descrizione descrittiva della parte denominata. Queste informazioni possono essere specificate con lineMakeCall e possono essere specificate facoltativamente nel parametro lpCallParams ogni volta che viene stabilita una nuova chiamata. È utile per scopi di registrazione delle chiamate. Le dimensioni del campo vengono specificate da dwCalledPartySize.

dwCommentSize

Dimensioni del campo commento, in byte.

dwCommentOffset

Offset dall'inizio della struttura al campo di dimensioni variabile che contiene un commento sulla chiamata fornita dall'applicazione che ha generato la chiamata usando lineMakeCall. Queste informazioni possono essere specificate facoltativamente nel parametro lpCallParams ogni volta che viene stabilita una nuova chiamata. Le dimensioni del campo sono specificate da dwCommentSize.

dwDisplaySize

Dimensioni delle informazioni di visualizzazione non elaborate, in byte.

dwDisplayOffset

Offset dall'inizio della struttura al campo di dimensioni variabile che contiene informazioni di visualizzazione non elaborate. A seconda dell'ambiente di telefonia, un provider di servizi può estrarre informazioni funzionali da questa coppia membro per la formattazione e la presentazione più appropriate per questa configurazione di telefonia. Le dimensioni del campo sono specificate da dwDisplaySize.

dwUserUserInfoSize

Dimensioni delle informazioni sull'utente, in byte. Se le informazioni utente sono un puntatore a una stringa, le dimensioni devono includere il terminatore Null.

dwUserUserInfoOffset

Offset dall'inizio della struttura al campo di dimensioni variabile che contiene informazioni utente-utente. Il campo di discriminazione del protocollo per le informazioni sull'utente, se usato, viene visualizzato come primo byte dei dati a cui fa riferimento dwUserUserInfoOffset e viene utilizzato in dwUserUserInfoSize.

dwHighLevelCompSize

Dimensioni delle informazioni di compatibilità di alto livello, in byte.

dwHighLevelCompOffset

Offset dall'inizio della struttura al campo di dimensioni variabile che contiene informazioni di compatibilità di alto livello. Il formato di queste informazioni viene specificato da altri standard (ISDN Q.931). Le dimensioni del campo vengono specificate da dwHighLevelCompSize.

dwLowLevelCompSize

Dimensioni delle informazioni di compatibilità di basso livello, in byte.

dwLowLevelCompOffset

Offset dall'inizio della struttura al campo di dimensioni variabile che contiene informazioni di compatibilità di basso livello. Il formato di queste informazioni viene specificato da altri standard (ISDN Q.931). Le dimensioni del campo vengono specificate da dwLowLevelCompSize.

dwChargingInfoSize

Dimensioni delle informazioni di ricarica, in byte.

dwChargingInfoOffset

Offset dall'inizio della struttura al campo di dimensioni variabile che contiene informazioni di ricarica. Il formato di queste informazioni viene specificato da altri standard (ISDN Q.931). Le dimensioni del campo sono specificate da dwChargingInfoSize.

dwTerminalModesSize

Dimensioni della matrice delle modalità terminale correnti, in byte.

dwTerminalModesOffset

Offset dall'inizio della struttura al campo dispositivo di dimensioni variabile contenente una matrice con voci di dimensioni DWORD. Le voci della matrice vengono indicizzate da identificatori del terminale, nell'intervallo compreso tra zero e uno minore di dwNumTerminals. Ogni voce della matrice specifica le modalità terminale correnti per il set di terminale corrispondente con la funzione lineSetTerminal per il flusso multimediale della chiamata, come specificato da una delle costanti LINETERMMODE_. Le dimensioni della matrice sono specificate da dwTerminalModesSize.

dwDevSpecificSize

Dimensioni del campo specifico del dispositivo, in byte.

dwDevSpecificOffset

Offset dall'inizio della struttura al campo di dimensioni variabile che contiene informazioni specifiche del dispositivo. La dimensione del campo è specificata da dwDevSpecificSize.

dwCallTreatment

Trattamento di chiamata attualmente applicato alla chiamata o applicato quando la chiamata entra nello stato applicabile successivo. Può essere zero se i trattamenti di chiamata non sono supportati.

dwCallDataSize

Dimensioni dei dati delle chiamate impostabili dall'applicazione, in byte.

dwCallDataOffset

Offset dall'inizio della struttura ai dati delle chiamate impostabili dall'applicazione. Le dimensioni del campo sono specificate da dwCallDataSize.

dwSendingFlowspecSize

Dimensioni della qualità delle informazioni sul servizio, in byte.

dwSendingFlowspecOffset

Offset dall'inizio della struttura a una struttura FLOWPEC seguita da dati specifici del provider WinSock, equivalenti a ciò che sarebbe stato archiviato in SendingFlowspec in una struttura QOS . Specifica la qualità del servizio attualmente in vigore nella direzione di invio della chiamata. La parte specifica del provider che segue la struttura FLOWPEC non deve contenere puntatori ad altri blocchi di memoria, perché TAPI non sa come eseguire il marshalling dei dati puntati dai puntatori privati e trasmetterlo tramite la comunicazione tra processi all'applicazione. Le dimensioni del campo sono specificate da dwSendingFlowspecSize.

dwReceivingFlowspecSize

Dimensioni della qualità delle informazioni sul servizio, in byte.

dwReceivingFlowspecOffset

Offset dall'inizio della struttura a una struttura FLOWPEC seguita da dati specifici del provider WinSock, equivalenti a ciò che sarebbe stato archiviato in ReceivingFlowspec in una struttura QOS . Specifica la qualità del servizio corrente in effetti nella direzione di ricezione della chiamata. La parte specifica del provider che segue la struttura FLOWPEC non deve contenere puntatori ad altri blocchi di memoria, perché TAPI non sa come eseguire il marshalling dei dati puntati dai puntatori privati e trasmetterlo tramite la comunicazione tra processi all'applicazione. Le dimensioni del campo sono specificate da dwReceivedFlowspecSize.

dwCallerIDAddressType

Tipo di indirizzo del chiamante. Questo membro della struttura è disponibile solo se la versione TAPI negoziata è 3.0 o successiva.

dwCalledIDAddressType

Tipo di indirizzo della parte chiamata. Questo membro della struttura è disponibile solo se la versione TAPI negoziata è 3.0 o successiva.

dwConnectedIDAddressType

Tipo di indirizzo della destinazione a cui è stata effettivamente connessa la chiamata. Questo membro della struttura è disponibile solo se la versione TAPI negoziata è 3.0 o successiva.

dwRedirectionIDAddressType

Tipo di indirizzo della nuova destinazione della chiamata. Questo membro della struttura è disponibile solo se la versione TAPI negoziata è 3.0 o successiva.

dwRedirectingIDAddressType

Tipo di indirizzo della posizione che ha reindirizzato la chiamata. Questo membro della struttura è disponibile solo se la versione TAPI negoziata è 3.0 o successiva.

Commenti

Le estensioni specifiche del dispositivo devono usare l'area devSpecific (dwDevSpecificSize e dwDevSpecificOffset) variamente ridimensionata di questa struttura di dati.

La struttura di dati LINECALLINFO contiene informazioni relativamente fisse su una chiamata. Questa struttura viene restituita con lineGetCallInfo. Quando gli elementi delle informazioni in questa struttura di dati sono stati modificati, viene inviato un messaggio di LINE_CALLINFO all'applicazione. Un parametro per questo messaggio è l'elemento di informazioni o il campo che è stato modificato.

I membri dwCallTreatment tramite dwReceivedFlowspecOffset sono disponibili solo per le applicazioni che aprono il dispositivo line con una versione API di 2.0 o successiva.

Nota Il formato preferito per specificare il contenuto del campo dwCallID e gli altri cinque campi simili (dwCallerIDFlag, dwCallerIDSize, dwCallerIDOffset, dwCallerIDNameSize e dwCallerIDNameOffset) è il formato di numero canonico TAPI. Ad esempio, un ICLID di "4258828080" ricevuto dall'opzione deve essere convertito in "+1 (425) 8828080" prima di essere inserito nella struttura LINECALLINFO . Questo formato standardizzato facilita la ricerca di database e funzioni di callback implementate nelle applicazioni.
 

Requisiti

Requisito Valore
Intestazione tapi.h

Vedi anche

LINECALLSTATUS

LINEDEVCAPS

LINEDIALPARAMS

LINETRANSLATEOUTPUT

LINE_CALLINFO

LINE_MONITORMEDIA

TSPI_lineGetCallInfo

lineGenerateDigits

lineGetCallInfo

lineGetCallStatus

lineInitializeEx

lineMakeCall

lineSecureCall

lineSetAppSpecific

lineSetCallParams

lineSetTerminal

lineTranslateAddress