TSPI_lineGetCallInfo, fonction (tspi.h)
La fonction TSPI_lineGetCallInfo retourne des informations détaillées sur l’appel spécifié.
Syntaxe
LONG TSPIAPI TSPI_lineGetCallInfo(
HDRVCALL hdCall,
LPLINECALLINFO lpCallInfo
);
Paramètres
hdCall
Handle du fournisseur de services pour l’appel dont les informations d’appel doivent être récupérées. L’état d’appel de hdCall peut être n’importe quel état.
lpCallInfo
Pointeur vers une structure de données de taille variable de type LINECALLINFO. Une fois la demande terminée, cette structure est remplie d’informations relatives aux appels.
Valeur retournée
Retourne zéro si la fonction réussit ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Remarques
Le tableau suivant indique les membres de la structure de données LINECALLINFO qui sont renseignés par TAPI et ceux qui sont renseignés par le fournisseur de services. Le fournisseur de services doit conserver (il ne doit pas remplacer) les valeurs renseignées par TAPI.
| Nom du membre | TAPI | Fournisseur de services |
|---|---|---|
| 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 remplit les champs de taille et de décalage pour les membres dwAppNameSize/Offset, dwCalledPartySize/Offset et dwCommentSize/Offset , et met à jour la valeur dans dwUsedSize pour les refléter après l’appel du fournisseur de services.
Une fois que le fournisseur de services est retourné à partir de la fonction TSPI_lineGetCallInfo , TAPI définit le membre dwCallStates de la structure LINECALLINFO comme suit :
LINECALLINFO.dwCallStates |= LINECALLSTATE_UNKNOWN;
Si le fournisseur de services modélise des lignes en tant que « pools » de ressources de canal et effectue un multiplexage inverse d’un appel sur plusieurs identificateurs d’adresse, il doit toujours choisir l’un de ces identificateurs d’adresse comme identificateur principal signalé par cette fonction dans la structure de données LINECALLINFO .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |