fonction lineMonitorTones (tapi.h)

  • Article

La fonction lineMonitorTones active et désactive la détection des tonalités inband sur l’appel. Chaque fois qu’un ton spécifié est détecté, un message est envoyé à l’application.

Syntaxe

LONG lineMonitorTones(
  HCALL                   hCall,
  LPLINEMONITORTONE const lpToneList,
  DWORD                   dwNumEntries
);

Paramètres

hCall

Gérez l’appel sur lequel les tonalités de canal vocal doivent être surveillées. L’état de l’appel de hCall peut être n’importe quel état, sauf inactif.

lpToneList

Liste des tons à surveiller. Ce paramètre est de type LINEMONITORTONE. Chaque tonalité de cette liste a un champ de balise défini par l’application qui est utilisé pour identifier les tons individuels dans la liste afin de signaler une détection de tonalité. L’analyse de tonalité en cours est annulée ou modifiée en appelant cette opération avec null pour lpToneList ou avec une autre liste de tonalités.

dwNumEntries

Nombre d’entrées dans lpToneList. Ce paramètre est ignoré si lpToneList a la valeurNULL.

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_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_INVALTONE, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Remarques

Cette fonction réussit si l’analyse de tonalité a été correctement lancée, et non lorsque l’analyse de tonalité est terminée. L’analyse de tonalité reste en vigueur jusqu’à ce qu’elle soit explicitement désactivée en appelant lineMonitorTones avec une autre liste de tonalités (ou NULL), jusqu’à ce que l’appel passe au mode inactif, ou lorsque l’application libère son handle d’appel pour l’appel.

Bien que cette fonction puisse être appelée dans n’importe quel état d’appel, les tonalités ne peuvent généralement être détectées que lorsque l’appel est à l’état connecté . La détection de tonalité nécessite généralement des ressources de calcul. Selon le fournisseur de services et d’autres activités qui sont en concurrence pour de telles ressources, le nombre de tonalités qui peuvent être détectées peut varier au fil du temps. En outre, une quantité équivalente de ressources peut être consommée pour la surveillance d’un seul tonalité de fréquence triple par rapport à trois tonalités de fréquence unique. Si les ressources sont surcommises, l’erreur LINEERR_RESOURCEUNAVAIL est retournée.

La fonction lineMonitorTones est également utilisée pour détecter le silence. Le silence est spécifié sous forme de tonalité avec une fréquence de zéro.

La surveillance des tons d’une téléconférence s’applique uniquement au hConfCall, et non aux appels individuels participants

Si la valeur d’erreur LINEERR_INVALPOINTER est retournée, le paramètre lpToneList spécifié n’est pas valide ou la valeur spécifiée par le paramètre dwNumEntries est trop grande.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête tapi.h
Bibliothèque Tapi32.lib
DLL Tapi32.dll

Voir aussi

LINEMONITORTONE

Fonctions de service de ligne supplémentaires

Vue d’ensemble de la référence TAPI 2.2