Partager via


LINE_MONITORTONE message

Le message tapi LINE_MONITORTONE est envoyé lorsqu’un ton est détecté. L’envoi de ce message est contrôlé avec la fonction lineMonitorTones .

            

Paramètres

hDevice

Handle de l’appel.

dwCallbackInstance

Le rappel instance fourni lors de l’ouverture de la ligne de l’appel.

dwParam1

Membre dwAppSpecific spécifique à l’application de la structure LINEMONITORTONE pour la tonalité détectée.

dwParam2

Inutilisé.

dwParam3

« Nombre de cases » (nombre de millisecondes depuis le début de Windows) auquel le ton a été détecté. Pour les versions d’API antérieures à 2.0, ce paramètre n’est pas utilisé.

Valeur retournée

Pas de valeur de retour.

Notes

Le message LINE_MONITORTONE est envoyé uniquement à l’application qui a demandé que le ton soit surveillé.

Étant donné que cet horodatage peut avoir été généré sur un ordinateur autre que celui sur lequel l’application s’exécute, il n’est utile que pour la comparaison avec d’autres messages horodatés similaires générés sur le même appareil de ligne (LINE_GATHERDIGITS, LINE_GENERATE, LINE_MONITORDIGITS, LINE_MONITORTONE), afin de déterminer leur minutage relatif (séparation entre les événements). Le nombre de graduations peut être « encapsulé » après environ 49,7 jours; les applications doivent en tenir compte lors de l’exécution de calculs.

Si le fournisseur de services ne génère pas l’horodatage (par exemple, s’il a été créé à l’aide d’une version antérieure de TAPI), TAPI fournit un horodatage au point le plus proche du fournisseur de services générant l’événement afin que l’horodatage synthétisé soit aussi précis que possible.

Spécifications

Condition requise Valeur
Version TAPI
Nécessite TAPI 2.0 ou version ultérieure
En-tête
Tapi.h

Voir aussi

LINE_GATHERDIGITS

LINE_GENERATE

LINE_MONITORDIGITS

LINEMONITORTONE

lineMonitorTones