LINE_GATHERDIGITS message

Le message de LINE_GATHERDIGITS TAPI est envoyé lorsque la demande de collecte de chiffres en mémoire tampon actuelle est terminée ou annulée. La mémoire tampon de chiffres peut être examinée une fois ce message reçu par l’application.

Paramètres

hDevice

Handle de l’appel.

dwCallbackInstance

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

dwParam1

Raison pour laquelle la collecte de chiffres a été arrêtée. Ce paramètre doit être une seule des constantes LINEGATHERTERM_.

dwParam2

Inutilisé.

dwParam3

« Nombre de graduations » (nombre de millisecondes depuis le démarrage de Windows) auquel la collecte du chiffre s’est terminée. Pour les versions TAPI antérieures à 2.0, ce paramètre n’est pas utilisé.

Valeur retournée

Pas de valeur de retour.

Notes

Le message LINE_GATHERDIGITS est envoyé uniquement à l’application qui a lancé la collecte de chiffres sur l’appel à l’aide de lineGatherDigits.

Si la fonction lineGatherDigits est utilisée pour annuler une demande précédente de collecte de chiffres, TAPI envoie un message LINE_GATHERDIGITS avec dwParam1 défini sur LINEGATHERTERM_CANCEL à l’application, indiquant que la mémoire tampon spécifiée à l’origine contient les chiffres collectés jusqu’à l’annulation.

Étant donné que l’horodatage spécifié par dwParam3 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 de la même façon générés sur le même périphérique de ligne (LINE_GENERATE, LINE_MONITORDIGITS, LINE_MONITORMEDIA, 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.

Notes

Lorsqu’une application appelle une opération asynchrone qui réécrit des données dans la mémoire de l’application, l’application doit conserver cette mémoire disponible pour l’écriture jusqu’à ce qu’un message LINE_REPLY ou LINE_GATHERDIGITS soit reçu.

Spécifications

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

Voir aussi

LINE_GENERATE

LINE_MONITORDIGITS

LINE_MONITORMEDIA

LINE_MONITORTONE

LINE_REPLY

lineGatherDigits