fonction lineSetMediaMode (tapi.h)

Article
08/26/2023

La fonction lineSetMediaMode définit le ou les types de média de l’appel spécifié dans sa structure LINECALLINFO . Pour plus d’informations, consultez ITLegacyCallMediaControl::SetMediaType.

Syntaxe

LONG lineSetMediaMode(
  HCALL hCall,
  DWORD dwMediaModes
);

Paramètres

hCall

Gérez l’appel dont le type de média doit être modifié. L’application doit être propriétaire de l’appel. L’état d’appel de hCall peut être n’importe quel état.

dwMediaModes

Nouveau(s) type(s) multimédia(s) pour l’appel. Ce paramètre utilise les constantes LINEMEDIAMODE_. Tant que l’indicateur de type de média INCONNU est défini, d’autres indicateurs de type multimé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 UNKNOWN n’est pas défini, un seul type de média peut être spécifié.

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONUNAVAIL.

Remarques

La fonction lineSetMediaMode modifie le type de média de l’appel dans sa structure LINECALLINFO . L’utilisation classique de cette opération consiste soit à définir le type de média d’un appel sur un type de média connu spécifique, soit à exclure les types de médias possibles tant que le type de média de l’appel est officiellement inconnu (l’indicateur type de média INCONNU est défini).