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 |
|