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