fonction lineSetCallParams (tapi.h)

Article
03/02/2024

La fonction lineSetCallParams permet à une application de modifier le mode du porteur et/ou les paramètres de débit d’un appel existant.

Syntaxe

LONG lineSetCallParams(
  HCALL                  hCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

Paramètres

hCall

Gérez l’appel dont les paramètres doivent être modifiés. L’application doit être propriétaire de l’appel. L’état de l’appel de hCall peut être n’importe quel état, sauf inactif ou déconnecté.

dwBearerMode

Nouveau mode porteur pour l’appel. Ce paramètre utilise une seule des constantes LINEBEARERMODE_.

dwMinRate

Limite inférieure pour le nouveau débit de données de l’appel. L’application peut accepter un nouveau taux aussi bas que celui-ci.

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 que l’application peut accepter. Si un débit de données exact est requis, dwMinRate et dwMaxRate doivent être égaux.

lpDialParams

Pointeur vers les nouveaux paramètres de numérotation pour l’appel, de type LINEDIALPARAMS. Ce paramètre peut être laissé NULL si les paramètres de numérotation actuels de l’appel doivent être utilisés.

Valeur retournée

Retourne un identificateur de requête positif si la fonction est terminée de manière asynchrone, ou un numéro d’erreur négatif si une erreur se produit. Le paramètre dwParam2 du message LINE_REPLY correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_BEARERMODEUNAVAIL, LINEERR_NOTOWNER, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RATEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALRATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

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.