fonction lineMonitorTones (tapi.h)
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 |