Struttura LINEADDRESSCAPS (tapi.h)

Articolo
08/26/2023

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.