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.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | tapi.h |