TSPI_lineSetMediaMode, fonction (tspi.h)
La fonction TSPI_lineSetMediaMode modifie le média de l’appel tel qu’il est stocké dans la structure LINECALLINFO de l’appel.
Syntaxe
LONG TSPIAPI TSPI_lineSetMediaMode(
HDRVCALL hdCall,
DWORD dwMediaMode
);
Paramètres
hdCall
Handle de l’appel faisant l’objet d’une modification du type de média. L’état d’appel de hdCall peut être n’importe quel état.
dwMediaMode
Nouveau(s) type(s) de média pour l’appel. Tant que l’indicateur de type de média LINEMEDIAMODE_UNKNOWN est défini, plusieurs autres indicateurs de type de média peuvent également être définis. Cela permet d’identifier le type de média d’un appel comme n’étant pas entièrement déterminé, mais limité à l’un des petits ensembles de types de médias spécifiés. Si l’indicateur LINEMEDIAMODE_UNKNOWN n’est pas défini, un seul type de média peut être spécifié. Ce paramètre utilise une (ou plusieurs) constantes LINEMEDIAMODE_.
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_OPERATIONUNAVAIL, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Remarques
Outre la modification du média de l’appel tel qu’il est stocké dans la structure LINECALLINFO de l’appel, cette procédure est simplement un conseil dans le sens où elle indique un changement de média attendu qui est sur le point de se produire, plutôt que de forcer une modification spécifique à l’appel. L’utilisation classique consiste à définir le type de média d’un appel sur un type de média connu spécifique, ou à exclure les types de médias possibles tant que le type de média de l’appel n’est pas entièrement connu (l’indicateur de type de média UNKNOWN est défini).
TAPI offre les garanties suivantes concernant le type de média passé : (1) il existe au moins un jeu de bits, (2) aucun bits réservé n’est défini et (3) si plusieurs bits sont définis, « Inconnu » est également défini. Le fournisseur de services doit effectuer d’autres vérifications de validité sur les types de médias, par exemple vérifier si les types de médias sont effectivement pris en charge par le fournisseur de services.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |