fonction TSPI_lineSetCallParams (tspi.h)

Article
03/06/2024

La fonction TSPI_lineSetCallParams définit certains paramètres pour un appel existant.

Syntaxe

LONG TSPIAPI TSPI_lineSetCallParams(
  DRV_REQUESTID          dwRequestID,
  HDRVCALL               hdCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdCall

Handle de l’appel dont les paramètres doivent être modifiés. L’état de l’appel peut être n’importe quel état, sauf inactif et déconnecté.

dwBearerMode

Nouveau mode porteur pour l’appel. Le paramètre dwBearerMode ne peut avoir qu’une seule constante LINEBEARERMODE_.

dwMinRate

Limite inférieure pour le nouveau débit de données de l’appel. TAPI peut accepter un nouveau taux aussi bas que celui-ci. TAPI ne valide pas ce paramètre lorsque cette fonction est appelée.

dwMaxRate

Limite supérieure pour le nouveau débit de données de l’appel. Il s’agit du débit de données maximal souhaité par TAPI. Des valeurs égales pour dwMinRate et dwMaxRate indiquent qu’un débit de données exact est requis. TAPI ne valide pas ce paramètre lorsque cette fonction est appelée.

lpDialParams

Pointeur vers les nouveaux paramètres de numérotation de l’appel, de type LINEDIALPARAMS. Si ce paramètre a la valeur NULL, cela indique que les paramètres de numérotation actuels de l’appel doivent être utilisés.

Valeur retournée

Retourne dwRequestID ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult du ASYNC_COMPLETION correspondant est 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_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_NOMEM, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALRATE, LINEERR_RESOURCEUNAVAIL, LINEERR_BEARERMODEUNAVAIL.

Remarques

Cette opération permet de modifier les paramètres d’un appel existant. Parmi les exemples de son utilisation, citons la modification du mode du porteur et/ou du débit de données d’un appel existant.