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	Tapi.h

Voir aussi

LINE_GATHERDIGITS

LINE_MONITORDIGITS

LINE_MONITORMEDIA

LINE_MONITORTONE