TSPI_lineGetCallInfo, fonction (tspi.h)

Article
03/03/2024

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

Share via