Struttura LINECALLPARAMS (tapi.h)

Articolo
08/26/2023

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_.

Nota Impossibile LINEADDRESSMODE_ADDRESSID il membro dwAddressMode per la chiamata alla funzione lineOpen . Tuttavia, questa restrizione non si applica a lineMakeCall.

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.

Nota I campi DialParams tramite dwDevSpecificOffset vengono ignorati quando viene specificato un parametro lpCallParams con la funzione lineOpen .

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