Message LINE_GENERATE
Le message TAPI LINE_GENERATE est envoyé pour informer l’application de l’arrêt de la génération actuelle de chiffre ou de tonalité. Une unique demande de génération de ce type peut être en cours dans un appel donné en permanence. Ce message est également envoyé à l’annulation de la génération de chiffres ou de tonalité.
Paramètres
-
hDevice
-
Un descripteur de l’appel.
-
dwCallbackInstance
-
L’instance de rappel fournie lors de l’ouverture de la ligne.
-
dwParam1
-
La raison pour laquelle la génération de chiffres ou de tonalité a été arrêtée. Ce paramètre doit être une des constantes LINEGENERATETERM_.
-
dwParam2
-
Inutilisé.
-
dwParam3
-
Le « nombre de cycles » (nombre de millisecondes depuis le démarrage de Windows) auquel la génération de chiffres ou de tonalité s’est terminée. Ce paramètre n’est pas utilisé pour les versions d’API antérieures à la version 2.0.
Valeur retournée
Aucune valeur renvoyée.
Notes
Le message LINE_GENERATE n’est envoyé qu’à l’application qui a demandé la génération de chiffres ou de tonalité.
L’horodatage étant spécifié par dwParam3, il a peut-être été généré sur un ordinateur autre que celui sur lequel l’application s’exécute. Il est utile uniquement pour la comparaison avec d’autres messages horodatés semblables, générés sur le même appareil de ligne (LINE_GATHERDIGITS, LINE_MONITORDIGITS, LINE_MONITORMEDIA, LINE_MONITORTONE) afin de déterminer la synchronisation relative (séparation entre les événements). Le nombre de cycles peut « continuer automatiquement » après environ 49,7 jours. Les applications doivent tenir compte de cela lors de l’exécution de calculs.
Si le fournisseur de services ne génère aucun horodatage (par exemple, s’il a été créé à l’aide d’une version antérieure de TAPI), TAPI fournit alors 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Version de TAPI |
Nécessite TAPI 2.0 ou une version ultérieure |
| En-tête |
|