funzione TSPI_lineGetCallInfo (tspi.h)
La funzione TSPI_lineGetCallInfo restituisce informazioni dettagliate sulla chiamata specificata.
Sintassi
LONG TSPIAPI TSPI_lineGetCallInfo(
HDRVCALL hdCall,
LPLINECALLINFO lpCallInfo
);
Parametri
hdCall
Handle del provider di servizi alla chiamata le cui informazioni sulla chiamata devono essere recuperate. Lo stato della chiamata di hdCall può essere qualsiasi stato.
lpCallInfo
Puntatore a una struttura di dati di dimensioni variabile di tipo LINECALLINFO. Al termine della richiesta, questa struttura viene riempita con informazioni correlate alle chiamate.
Valore restituito
Restituisce zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Commenti
La tabella seguente indica i membri della struttura di dati LINECALLINFO compilati da TAPI e i membri compilati dal provider di servizi. Il provider di servizi deve mantenere (non deve sovrascrivere) i valori compilati da TAPI.
| Nome del membro | TAPI | Provider di servizi |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| hLine; | X | |
| dwLineDeviceID; | X | |
| dwAddressID; | X | |
| dwBearerMode; | X | |
| dwRate; | X | |
| dwMediaMode; | X | |
| dwAppSpecific; | X | |
| dwCallID; | X | |
| dwRelatedCallID; | X | |
| dwCallParamFlags; | X | |
| dwCallStates; | X | X |
| dwMonitorDigitModes; | X | |
| dwMonitorMediaModes; | X | |
| DialParams; | X | |
| dwOrigin; | X | |
| dwReason; | X | |
| dwCompletionID; | X | |
| dwNumOwners; | X | |
| dwNumMonitors; | X | |
| dwCountryCode; | X | |
| dwTrunk; | X | |
| dwCallerIDFlags; | X | |
| dwCallerIDSize; | X | |
| dwCallerIDOffset; | X | |
| dwCallerIDNameSize; | X | |
| dwCallerIDNameOffset; | X | |
| dwCalledIDFlags; | X | |
| dwCalledIDSize; | X | |
| dwCalledIDOffset; | X | |
| dwCalledIDNameSize; | X | |
| dwCalledIDNameOffset; | X | |
| dwConnectedIDFlags; | X | |
| dwConnectedIDSize; | X | |
| dwConnectedIDOffset; | X | |
| dwConnectedIDNameSize; | X | |
| dwConnectedIDNameOffset; | X | |
| dwRedirectionIDFlags; | X | |
| dwRedirectionIDSize; | X | |
| dwRedirectionIDOffset; | X | |
| dwRedirectionIDNameSize; | X | |
| dwRedirectionIDNameOffset; | X | |
| dwRedirectingIDFlags; | X | |
| dwRedirectingIDSize; | X | |
| dwRedirectingIDOffset; | X | |
| dwRedirectingIDNameSize; | X | |
| dwRedirectingIDNameOffset; | X | |
| dwAppNameSize; | X | |
| dwAppNameOffset; | X | |
| dwDisplayableAddressSize; | X | |
| dwDisplayableAddressOffset; | X | |
| dwCalledPartySize; | X | |
| dwCalledPartyOffset; | X | |
| dwCommentSize; | X | |
| dwCommentOffset; | X | |
| dwDisplaySize; | X | |
| dwDisplayOffset; | X | |
| dwUserUserInfoSize; | X | |
| dwUserUserInfoOffset; | X | |
| dwHighLevelCompSize; | X | |
| dwHighLevelCompOffset; | X | |
| dwLowLevelCompSize; | X | |
| dwLowLevelCompOffset; | X | |
| dwChargingInfoSize; | X | |
| dwChargingInfoOffset; | X | |
| dwTerminalModesSize; | X | |
| dwTerminalModesOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TAPI riempie i campi dimensioni e offset per i membri dwAppNameSize/Offset, dwCalledPartySize/Offset e dwCommentSize/Offset e aggiorna il valore in dwUsedSize per riflettere questi elementi dopo aver chiamato il provider di servizi.
Dopo che il provider di servizi restituisce dalla funzione TSPI_lineGetCallInfo , TAPI imposta il membro dwCallStates della struttura LINECALLINFO come indicato di seguito:
LINECALLINFO.dwCallStates |= LINECALLSTATE_UNKNOWN;
Se il provider di servizi modella le righe come "pool" di risorse del canale ed esegue il multiplexing inverso di una chiamata a più identificatori di indirizzo, deve scegliere in modo coerente uno di questi identificatori di indirizzo come identificatore primario segnalato da questa funzione nella struttura di dati LINECALLINFO .
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |