Struttura LINECALLPARAMS (tapi.h)
La struttura LINECALLPARAMS descrive i parametri forniti durante l'esecuzione di chiamate usando le funzioni lineMakeCall e TSPI_lineMakeCall . La struttura LINECALLPARAMS viene usata anche come parametro in altre operazioni, ad esempio la funzione lineOpen .
I commenti a destra del blocco di sintassi indicano i valori predefiniti usati quando questa struttura non viene fornita a lineMakeCall.
Sintassi
typedef struct linecallparams_tag {
DWORD dwTotalSize;
DWORD dwBearerMode;
DWORD dwMinRate;
DWORD dwMaxRate;
DWORD dwMediaMode;
DWORD dwCallParamFlags;
DWORD dwAddressMode;
DWORD dwAddressID;
LINEDIALPARAMS DialParams;
DWORD dwOrigAddressSize;
DWORD dwOrigAddressOffset;
DWORD dwDisplayableAddressSize;
DWORD dwDisplayableAddressOffset;
DWORD dwCalledPartySize;
DWORD dwCalledPartyOffset;
DWORD dwCommentSize;
DWORD dwCommentOffset;
DWORD dwUserUserInfoSize;
DWORD dwUserUserInfoOffset;
DWORD dwHighLevelCompSize;
DWORD dwHighLevelCompOffset;
DWORD dwLowLevelCompSize;
DWORD dwLowLevelCompOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwPredictiveAutoTransferStates;
DWORD dwTargetAddressSize;
DWORD dwTargetAddressOffset;
DWORD dwSendingFlowspecSize;
DWORD dwSendingFlowspecOffset;
DWORD dwReceivingFlowspecSize;
DWORD dwReceivingFlowspecOffset;
DWORD dwDeviceClassSize;
DWORD dwDeviceClassOffset;
DWORD dwDeviceConfigSize;
DWORD dwDeviceConfigOffset;
DWORD dwCallDataSize;
DWORD dwCallDataOffset;
DWORD dwNoAnswerTimeout;
DWORD dwCallingPartyIDSize;
DWORD dwCallingPartyIDOffset;
DWORD dwAddressType;
} LINECALLPARAMS, *LPLINECALLPARAMS;
Members
dwTotalSize
Dimensioni totali assegnate a questa struttura di dati, in byte. Questa dimensione deve essere abbastanza grande per contenere tutte le parti fisse e variamente ridimensionate di questa struttura di dati.
dwBearerMode
Modalità di connessione per la chiamata. Questo membro usa una delle costanti LINEBEARERMODE_.
Se dwBearerMode è zero, il valore predefinito è LINEBEARERMODE_VOICE.
dwMinRate
Frequenza minima dei dati richiesta per il flusso di dati della chiamata, in bps (bit al secondo).
dwMaxRate
Velocità massima dei dati richiesta per il flusso di dati della chiamata, in bps (bit al secondo). Quando si effettua una chiamata, il provider di servizi tenta di fornire la frequenza più elevata disponibile nell'intervallo richiesto (dwMinRate a dwMaxRate). Se è necessaria una frequenza di dati specifica, sia dwMinRate che dwMaxRate deve essere impostata su tale valore. Se un'applicazione funziona meglio con una frequenza, ma è in grado di ridurre i tassi, l'applicazione deve specificare questi valori rispettivamente come velocità massima e minima. Se dwMaxRate è zero, il valore predefinito è specificato dal membro dwMaxRate della struttura LINEDEVCAPS . Si tratta della frequenza massima supportata dal dispositivo.
dwMediaMode
Tipo di supporto previsto della chiamata. Questo membro usa una delle costanti LINEMEDIAMODE_.
Se dwMediaMode è zero, il valore predefinito è LINEMEDIAMODE_INTERACTIVEVOICE.
dwCallParamFlags
Raccolta di parametri di configurazione delle chiamate booleane. Questo membro usa una o più costanti LINECALLPARAMFLAGS_.
dwAddressMode
Modalità in base alla quale viene specificato l'indirizzo di origine. Questo membro usa una delle costanti LINEADDRESSMODE_.
dwAddressID
Identificatore di indirizzo dell'indirizzo di origine se dwAddressMode è impostato su LINEADDRESSMODE_ADDRESSID. Un identificatore di indirizzo è associato definitivamente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.
DialParams
Parametri di composizione da usare in questa chiamata, di tipo LINEDIALPARAMS. Quando viene specificato un valore 0 per questo campo, il valore predefinito per il campo viene usato come indicato nel membro DefaultDialParams della struttura LINEDEVCAPS . Se viene specificato un valore diverso da zero per un campo esterno all'intervallo specificato dai campi corrispondenti in MinDialParams e MaxDialParams nella struttura LINEDEVCAPS , viene invece usato il valore più vicino all'interno dell'intervallo valido.
dwOrigAddressSize
Dimensioni del campo indirizzo di origine, in byte.
dwOrigAddressOffset
Offset dall'inizio della struttura al campo di dimensioni variabile che contiene l'indirizzo di origine. Il formato di questo indirizzo dipende dal membro dwAddressMode . La dimensione del campo è specificata da dwOrigAddressSize.
dwDisplayableAddressSize
Dimensioni della stringa visualizzabile, inclusa la terminazione Null , in byte.
dwDisplayableAddressOffset
Stringa visualizzabile usata per scopi di registrazione. Il contenuto di questi membri viene registrato nei membri dwDisplayableAddressOffset e dwDisplayableAddressSize del messaggio LINECALLINFO della chiamata. La funzione lineTranslateAddress restituisce informazioni appropriate da inserire in questo campo nella struttura dwDisplayableAddressSize e dwDisplayableAddressOffset della struttura LINETRANSLATEOUTPUT. Le dimensioni del campo vengono specificate da dwDisplayableAddressSize.
dwCalledPartySize
Dimensioni delle informazioni denominate parti, in byte.
dwCalledPartyOffset
Offset dall'inizio della struttura al campo di dimensioni variabile che contiene informazioni denominate parti. Queste informazioni possono essere specificate dall'applicazione che rende la chiamata e sono rese disponibili nella struttura delle informazioni della chiamata a scopo di registrazione. Il formato di questo campo è quello di dwStringFormat, come specificato in LINEDEVCAPS. Le dimensioni del campo vengono specificate da dwCalledPartySize.
dwCommentSize
Dimensioni del campo commento chiamata, in byte.
dwCommentOffset
Offset dall'inizio della struttura al campo di dimensioni variabile che contiene commenti sulla chiamata. Queste informazioni possono essere specificate dall'applicazione che rende la chiamata e sono rese disponibili nella struttura delle informazioni della chiamata a scopo di registrazione. Il formato di questo campo è quello di dwStringFormat, come specificato in LINEDEVCAPS. Le dimensioni del campo sono specificate da dwCommentSize.
dwUserUserInfoSize
Dimensioni delle informazioni utente, tra cui il terminatore Null , in byte.
dwUserUserInfoOffset
Offset dall'inizio della struttura al campo di dimensioni variabile che contiene informazioni utente-utente. Se necessario, il campo di discriminazione del protocollo per le informazioni sull'utente deve essere visualizzato come primo byte dei dati a cui punta dwUserUserInfoOffset e deve essere 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. 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. Le dimensioni del campo vengono specificate da dwLowLevelCompSize.
dwDevSpecificSize
Dimensioni delle informazioni specifiche 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.
dwPredictiveAutoTransferStates
LINECALLSTATE_ costanti, ingresso in cui la chiamata viene trasferita in modo cieco all'indirizzo di destinazione specificato. Impostare su zero se il trasferimento automatico non è desiderato.
dwTargetAddressSize
Dimensioni della stringa di indirizzi dialable di destinazione, tra cui il terminatore Null , in byte.
dwTargetAddressOffset
Offset dall'inizio della struttura a una stringa che specifica l'indirizzo chiamabile di destinazione (non dwAddressID); usato nel caso di determinate azioni automatiche. Nel caso della composizione predittiva, specifica l'indirizzo a cui deve essere trasferita automaticamente la chiamata. Le dimensioni della stringa vengono specificate da dwTargetAddressSize.
Si tratta essenzialmente della stessa stringa che verrebbe passata a lineBlindTransfer se il trasferimento automatico non veniva usato. Impostare su zero se il trasferimento automatico non è desiderato. Nel caso di una conferenza No Hold, specifica l'indirizzo che deve essere conferenza alla chiamata. Nel caso di un trasferimento in un passaggio, specifica l'indirizzo da chiamare per la chiamata di consulenza.
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 desiderata 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 desiderata 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.
dwDeviceClassSize
Dimensioni della stringa della classe di dispositivo, tra cui il terminatore Null , in byte.
dwDeviceClassOffset
Offset dall'inizio della struttura a una stringa con terminazione null che indica la classe di dispositivo del dispositivo la cui configurazione è specificata in DeviceConfig. Le stringhe della classe di dispositivo valide sono uguali a quelle specificate per la funzione lineGetID . Le dimensioni della stringa sono specificate da dwDeviceClassSize.
dwDeviceConfigSize
Dimensioni dei dati di configurazione del dispositivo, in byte.
dwDeviceConfigOffset
Offset dall'inizio della struttura alla struttura di dati di configurazione opaca. Questo valore viene restituito nel membro dwStringSize nella struttura VARSTRING restituito da lineGetDevConfig. Se la dimensione è zero, viene usata la configurazione predefinita del dispositivo. Ciò consente all'applicazione di impostare la configurazione del dispositivo prima dell'avvio della chiamata. Le dimensioni del campo sono specificate da dwDeviceConfigSize.
dwCallDataSize
Dimensioni dei dati delle chiamate impostabili dall'applicazione, in byte.
dwCallDataOffset
Offset dall'inizio della struttura ai dati delle chiamate impostabili dall'applicazione da associare inizialmente alla chiamata. Le dimensioni del campo sono specificate da dwCallDataSize.
dwNoAnswerTimeout
Numero di secondi, dopo il completamento della composizione, che la chiamata deve essere autorizzata ad attendere negli stati PROCEEDING o RINGBACK, prima che venga abbandonata automaticamente dal provider di servizi con un LINECALLSTATE_DISCONNECTED e un LINEDISCONNECTMODE_NOANSWER. Il valore 0 indica che l'applicazione non desidera l'abbandono automatico delle chiamate.
dwCallingPartyIDSize
Dimensioni della stringa ID di entità chiamante, incluso il carattere di terminazione Null , in byte, incluso il carattere di terminazione Null.
dwCallingPartyIDOffset
Offset dall'inizio della struttura a una stringa con terminazione Null che specifica l'identità dell'entità che effettua la chiamata. Se il contenuto dell'identificatore è accettabile e un percorso è disponibile, il provider di servizi passa l'identificatore alla parte chiamata per indicare l'identità della parte chiamante. Le dimensioni del campo sono specificate da dwCallingPartyIDSize.
dwAddressType
Tipo di indirizzo utilizzato per 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 di dimensioni variabili DevSpecific (dwDevSpecificSize e dwDevSpecificOffset) di questa struttura di dati.
Questa struttura viene usata come parametro per lineMakeCall durante la configurazione di una chiamata. I campi consentono all'applicazione di specificare la qualità del servizio richiesta dalla rete, nonché un'ampia gamma di parametri di configurazione delle chiamate ISDN. Se non viene fornita alcuna struttura LINECALLPARAMS a lineMakeCall, viene richiesta una chiamata di livello vocale POTS predefinita con i valori predefiniti elencati in precedenza.
Requisiti
| Intestazione | tapi.h |