Struttura LINEADDRESSCAPS (tapi.h)
La struttura LINEADDRESSCAPS descrive le funzionalità di un indirizzo specificato. La funzione lineGetAddressCaps e la funzione TSPI_lineGetAddressCaps restituiscono la struttura LINEADDRESSCAPS .
Sintassi
typedef struct lineaddresscaps_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwLineDeviceID;
DWORD dwAddressSize;
DWORD dwAddressOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwAddressSharing;
DWORD dwAddressStates;
DWORD dwCallInfoStates;
DWORD dwCallerIDFlags;
DWORD dwCalledIDFlags;
DWORD dwConnectedIDFlags;
DWORD dwRedirectionIDFlags;
DWORD dwRedirectingIDFlags;
DWORD dwCallStates;
DWORD dwDialToneModes;
DWORD dwBusyModes;
DWORD dwSpecialInfo;
DWORD dwDisconnectModes;
DWORD dwMaxNumActiveCalls;
DWORD dwMaxNumOnHoldCalls;
DWORD dwMaxNumOnHoldPendingCalls;
DWORD dwMaxNumConference;
DWORD dwMaxNumTransConf;
DWORD dwAddrCapFlags;
DWORD dwCallFeatures;
DWORD dwRemoveFromConfCaps;
DWORD dwRemoveFromConfState;
DWORD dwTransferModes;
DWORD dwParkModes;
DWORD dwForwardModes;
DWORD dwMaxForwardEntries;
DWORD dwMaxSpecificEntries;
DWORD dwMinFwdNumRings;
DWORD dwMaxFwdNumRings;
DWORD dwMaxCallCompletions;
DWORD dwCallCompletionConds;
DWORD dwCallCompletionModes;
DWORD dwNumCompletionMessages;
DWORD dwCompletionMsgTextEntrySize;
DWORD dwCompletionMsgTextSize;
DWORD dwCompletionMsgTextOffset;
DWORD dwAddressFeatures;
DWORD dwPredictiveAutoTransferStates;
DWORD dwNumCallTreatments;
DWORD dwCallTreatmentListSize;
DWORD dwCallTreatmentListOffset;
DWORD dwDeviceClassesSize;
DWORD dwDeviceClassesOffset;
DWORD dwMaxCallDataSize;
DWORD dwCallFeatures2;
DWORD dwMaxNoAnswerTimeout;
DWORD dwConnectedModes;
DWORD dwOfferingModes;
DWORD dwAvailableMediaModes;
} LINEADDRESSCAPS, *LPLINEADDRESSCAPS;
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.
dwLineDeviceID
Identificatore del dispositivo di riga a cui è associato questo indirizzo.
dwAddressSize
Dimensioni del campo dell'indirizzo, in byte.
dwAddressOffset
Offset dall'inizio della struttura al campo indirizzo con dimensioni variabili. Le dimensioni del campo vengono specificate da dwAddressSize.
dwDevSpecificSize
Dimensioni del campo specifico del dispositivo, in byte.
dwDevSpecificOffset
Offset dall'inizio della struttura al campo specifico del dispositivo di dimensioni variabili. Le dimensioni del campo vengono specificate da dwDevSpecificSize.
dwAddressSharing
Modalità di condivisione dell'indirizzo. Questo membro può essere una delle costanti LINEADDRESSSHARING_.
dwAddressStates
Gli stati di indirizzo cambiano per i quali l'applicazione può ricevere una notifica nel messaggio LINE_ADDRESSSTATE. Questo membro utilizza una o più costanti LINEADDRESSSTATE_.
dwCallInfoStates
Chiamare elementi informativi significativi per tutte le chiamate a questo indirizzo. Un'applicazione può ricevere una notifica sulle modifiche apportate in alcuni di questi stati nei messaggi LINE_CALLINFO . Questo membro utilizza una o più costanti LINECALLINFOSTATE_.
dwCallerIDFlags
Tipi di informazioni sull'identificatore di entità che possono essere forniti per le chiamate a questo indirizzo. Il chiamante è l'origine della sessione. Una o più costanti LINECALLPARTYID_.
dwCalledIDFlags
Tipi di informazioni sull'identificatore di entità che possono essere forniti per le chiamate a questo indirizzo. In questo caso, "chiamato" fa riferimento alla destinazione originale. Una o più costanti LINECALLPARTYID_.
dwConnectedIDFlags
Tipi di informazioni sull'identificatore di entità che possono essere forniti per le chiamate a questo indirizzo. Una o più costanti LINECALLPARTYID_.
dwRedirectionIDFlags
Tipi di informazioni sull'identificatore di entità che possono essere forniti per le chiamate a questo indirizzo. In questo caso, "reindirizzamento" è la nuova destinazione. Una o più costanti LINECALLPARTYID_.
dwRedirectingIDFlags
Tipi di informazioni sull'identificatore di entità che possono essere forniti per le chiamate a questo indirizzo. In questo caso, "reindirizzamento" è l'indirizzo che ha richiamato il reindirizzamento. Una o più costanti LINECALLPARTYID_.
dwCallStates
Stati di chiamata che possono essere segnalati per le chiamate su questo indirizzo. Questo membro utilizza una o più costanti LINECALLSTATE_.
dwDialToneModes
Modalità di tono di chiamata che possono essere segnalate per le chiamate effettuate su questo indirizzo. Questo membro è significativo solo se è possibile segnalare lo stato della chiamata dialtone . Questo membro utilizza una o più costanti LINEDIALTONEMODE_.
dwBusyModes
Modalità occupato che possono essere segnalate per le chiamate effettuate su questo indirizzo. Questo membro è significativo solo se è possibile segnalare lo stato di chiamata occupato . Questo membro utilizza una o più costanti LINEBUSYMODE_.
dwSpecialInfo
Tipi di informazioni speciali che possono essere segnalati per le chiamate effettuate su questo indirizzo. Questo membro è significativo solo se è possibile segnalare lo stato della chiamata specialInfo . Questo membro utilizza una o più costanti LINESPECIALINFO_.
dwDisconnectModes
Modalità di disconnessione che possono essere segnalate per le chiamate effettuate su questo indirizzo. Questo membro è significativo solo se è possibile segnalare lo stato della chiamata disconnessa . Questo membro utilizza una o più costanti LINEDISCONNECTMODE_.
dwMaxNumActiveCalls
Numero massimo di apparizioni di chiamate attive che l'indirizzo può gestire. Questo numero non include chiamate in attesa o chiamate in attesa di trasferimento o conferenza.
dwMaxNumOnHoldCalls
Numero massimo di apparenze di chiamata nell'indirizzo che può essere in attesa.
dwMaxNumOnHoldPendingCalls
Numero massimo di apparizioni di chiamate all'indirizzo che possono essere in attesa di trasferimento o conferenza.
dwMaxNumConference
Numero massimo di parti che possono partecipare a una singola conferenza telefonica su questo indirizzo.
dwMaxNumTransConf
Numero di parti (incluso "self") che possono essere aggiunte in una conferenza telefonica avviata come chiamata di consultazione generica tramite lineSetupTransfer.
dwAddrCapFlags
Flag di bit compressi che descrivono un'ampia gamma di funzionalità di indirizzo. Questo membro utilizza una o più costanti LINEADDRCAPFLAGS_.
dwCallFeatures
Cambiare funzionalità o funzionalità disponibili per tutte le chiamate a questo indirizzo usando le costanti LINECALLFEATURE_. Questo membro rappresenta le funzionalità correlate alle chiamate che potrebbero essere disponibili in un indirizzo (disponibilità statica anziché disponibilità dinamica). Per richiamare una funzionalità supportata è necessario che la chiamata sia nello stato corretto e che il dispositivo linea sottostante venga aperto in modalità compatibile. Uno zero in una posizione di bit indica che la funzionalità corrispondente non è mai disponibile. Uno indica che la funzionalità corrispondente può essere disponibile se l'applicazione dispone dei privilegi appropriati per la chiamata e la chiamata è nello stato appropriato affinché l'operazione sia significativa. Questo membro consente a un'applicazione di individuare quali funzionalità di chiamata possono essere (e che non possono mai essere) supportate dall'indirizzo.
dwRemoveFromConfCaps
Funzionalità dell'indirizzo per la rimozione delle chiamate da una conferenza telefonica. Questo membro utilizza una delle costanti LINEREMOVEFROMCONF_.
dwRemoveFromConfState
Utilizza le costanti LINECALLSTATE_ per specificare lo stato della chiamata dopo che è stato rimosso da una conferenza telefonica.
dwTransferModes
Funzionalità dell'indirizzo per la risoluzione delle richieste di trasferimento. Questo membro utilizza una delle costanti LINETRANSFERMODE_.
dwParkModes
Diverse modalità di parcheggio di chiamata disponibili in questo indirizzo. Questo membro utilizza una delle costanti LINEPARKMODE_.
dwForwardModes
Modalità di inoltro diverse disponibili per questo indirizzo. Questo membro utilizza le costanti LINEFORWARDMODE_.
dwMaxForwardEntries
Numero massimo di voci che è possibile passare a lineForward nel parametro lpForwardList .
dwMaxSpecificEntries
Numero massimo di voci nel parametro lpForwardList passato a lineForward che può contenere istruzioni di inoltro in base a un ID chiamante specifico (inoltro selettivo delle chiamate). Questo membro è zero se l'inoltro selettivo delle chiamate non è supportato.
dwMinFwdNumRings
Numero minimo di anelli che possono essere impostati per determinare quando una chiamata è ufficialmente considerata "nessuna risposta".
dwMaxFwdNumRings
Numero massimo di anelli che possono essere impostati per determinare quando una chiamata è considerata ufficialmente "nessuna risposta". Se questo numero di anelli non può essere impostato, dwMinFwdNumRings e dwMaxNumRings sono uguali.
dwMaxCallCompletions
Numero massimo di richieste di completamento delle chiamate simultanee che possono essere in sospeso in questo dispositivo di riga. Zero implica che il completamento delle chiamate non è disponibile.
dwCallCompletionConds
Diverse condizioni di chiamata in cui è possibile richiedere il completamento delle chiamate. Questo membro utilizza una o più costanti LINECALLCOMPLCOND_.
dwCallCompletionModes
Modo in cui è possibile completare la chiamata. Questo membro utilizza una delle costanti LINECALLCOMPLMODE_.
dwNumCompletionMessages
Numero di messaggi di completamento delle chiamate che è possibile selezionare quando si usa l'opzione LINECALLCOMPLMODE_MESSAGE. I singoli messaggi vengono identificati dai valori nell'intervallo da zero a uno minore di dwNumCompletionMessages.
dwCompletionMsgTextEntrySize
Dimensioni di ognuna delle descrizioni del testo di completamento delle chiamate specificate da dwCompletionMsgTextSize e dwCompletionMsgTextOffset, in byte.
dwCompletionMsgTextSize
Dimensioni del testo di completamento della chiamata, in byte.
dwCompletionMsgTextOffset
Offset dall'inizio di questa struttura di dati al campo di dimensioni variabile contenente testo descrittivo su ognuno dei messaggi di completamento della chiamata. Ogni messaggio è lungo byte dwCompletionMsgTextEntrySize . Il formato stringa di queste descrizioni testuali è indicato da dwStringFormat nelle funzionalità del dispositivo della riga. Le dimensioni del campo vengono specificate da dwCompletionMsgTextSize.
dwAddressFeatures
Funzionalità disponibili per questo indirizzo usando le costanti LINEADDRFEATURE_. Per richiamare una funzionalità supportata è necessario che l'indirizzo sia nello stato corretto e che il dispositivo linea sottostante venga aperto in modalità compatibile. Uno zero in una posizione di bit indica che la funzionalità corrispondente non è mai disponibile. Uno indica che la funzionalità corrispondente può essere disponibile se l'indirizzo è nello stato appropriato affinché l'operazione sia significativa. Questo membro consente a un'applicazione di individuare quali funzionalità di indirizzo possono essere (e che non possono mai essere) supportate dall'indirizzo.
dwPredictiveAutoTransferStates
Chiamare lo stato o gli stati su cui una chiamata effettuata da un dialer predittivo può essere impostata per trasferire automaticamente la chiamata a un altro indirizzo; una o più costanti LINECALLSTATE_. Il valore 0 indica che il trasferimento automatico in base allo stato della chiamata non è disponibile.
dwNumCallTreatments
Numero di voci nella matrice di strutture LINECALLTREATMENTENTRY delimitate da dwCallTreatmentListSize e dwCallTreatmentListOffset.
dwCallTreatmentListSize
Dimensioni della matrice di trattamento delle chiamate, in byte.
dwCallTreatmentListOffset
Offset dall'inizio della struttura a una matrice di strutture LINECALLTREATMENTENTRY , specificare i trattamenti di chiamata supportati nell'indirizzo (che può essere selezionato utilizzando lineSetCallTreatment). Il valore è dwNumCallTreatments times SIZEOF(LINECALLTREATMENTENTRY). Le dimensioni del campo sono specificate da dwCallTreatmentListSize.
dwDeviceClassesSize
Dimensioni dell'elenco delle classi di dispositivi supportate, in byte.
dwDeviceClassesOffset
Offset dall'inizio della struttura a una stringa costituita dagli identificatori di classe del dispositivo supportati in questo indirizzo per l'uso con lineGetID. Gli elementi sono separati da caratteri Null e l'ultimo identificatore di classe è seguito da due caratteri Null . Le dimensioni del campo sono specificate da dwDeviceClassesSize.
dwMaxCallDataSize
Numero massimo di byte che un'applicazione può impostare in LINECALLINFO usando lineSetCallData.
dwCallFeatures2
Funzionalità aggiuntive di commutazione o funzionalità disponibili per tutte le chiamate a questo indirizzo usando le costanti LINECALLFEATURE2_. Si tratta di un'estensione del membro dwCallFeatures .
dwMaxNoAnswerTimeout
Valore massimo in secondi che è possibile impostare nel membro dwNoAnswerTimeout in LINECALLPARAMS durante l'esecuzione di una chiamata. Il valore 0 indica che l'abbandono automatico delle chiamate senza risposta non è supportato dal provider di servizi o che il valore di timeout non è modificabile dalle applicazioni.
dwConnectedModes
LINECONNECTEDMODE_ valori che possono essere visualizzati nel membro dwCallStateMode di LINECALLSTATUS e nei messaggi LINE_CALLSTATE per le chiamate a questo indirizzo.
dwOfferingModes
LINEOFFERINGMODE_ valori che possono essere visualizzati nel membro dwCallStateMode di LINECALLSTATUS e nei messaggi LINE_CALLSTATE per le chiamate a questo indirizzo.
dwAvailableMediaModes
Tipi di supporti (modalità) che possono essere richiamati su nuove chiamate create in questo indirizzo, quando il membro dwAddressFeatures indica che sono possibili nuove chiamate. Se questo membro è zero, indica che il provider di servizi non conosce o non può indicare quali tipi di supporti sono disponibili, nel qual caso uno o tutti i tipi di supporti indicati nel membro dwMediaModes in LINEDEVCAPS potrebbero essere disponibili.
Commenti
Le estensioni specifiche del dispositivo devono usare l'area di dimensioni variabili DevSpecific (dwDevSpecificSize e dwDevSpecificOffset) di questa struttura di dati.
Le applicazioni meno recenti vengono compilate senza questo membro nella struttura LINEADDRESSCAPS e usano un valore SIZEOF(LINEADDRESSCAPS) inferiore alle nuove dimensioni. L'applicazione passa un parametro dwAPIVersion con la funzione lineGetAddressCaps , che può essere usata per indicazioni da TAPI nella gestione di questa situazione. Se l'applicazione passa un membro dwTotalSize minore della dimensione della parte fissa della struttura, come definito nel membro dwAPIVersion specificato, viene restituito LINEERR_STRUCTURETOOSMALL. Se è stata allocata memoria sufficiente dall'applicazione, prima di chiamare TSPI_lineGetAddressCaps, TAPI imposta i membri dwNeededSize e dwUsedSize sulle dimensioni fisse della struttura come esiste nella versione dell'API specificata.
I nuovi provider di servizi (che supportano la nuova versione dell'API) devono esaminare la versione dell'API passata. Se la versione dell'API è inferiore alla versione più recente supportata dal provider, il provider di servizi non deve compilare campi non supportati nelle versioni precedenti dell'API, perché queste rientrano nella parte variabile della struttura precedente.
Le nuove applicazioni devono essere riconosciute della versione dell'API negoziata e non esaminare il contenuto dei campi nella parte fissa oltre la fine originale della parte fissa della struttura per la versione dell'API negoziata.
I membri dwPredictiveAutoTransferStates tramite dwAvailableMediaModes sono disponibili solo per le applicazioni che richiedono una versione API 2.0 o successiva quando si chiama lineGetAddressCaps.
Requisiti
| Intestazione | tapi.h |