_Message MONITORMEDIA de ligne

Le message _ MONITORMEDIA de ligne TAPI est envoyé lorsqu’une modification est détectée dans le type de média de l’appel. L’envoi de ce message est contrôlé à l’aide de la fonction lineMonitorMedia .

            

Paramètres

hDevice

Handle de l’appel.

dwCallbackInstance

Instance de rappel fournie lors de l’ouverture de la ligne.

dwParam1

Nouveau type de média (ou mode). Ce paramètre doit être une et une seule des _ constantes LINEMEDIAMODE.

dwParam2

Inutilisé.

dwParam3

« nombre de cycles » (nombre de millisecondes depuis Windows démarré) auquel le média spécifié a été détecté. Pour les versions TAPI antérieures à 2,0, ce paramètre n’est pas utilisé.

Valeur de retour

Pas de valeur de retour.

Notes

Le message de ligne _ MONITORMEDIA est envoyé à l’application qui a activé la surveillance du média pour le type de média détecté.

Étant donné que cet horodateur peut avoir é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 de même horodatage générés sur le même appareil de ligne ( ligne _ GATHERDIGITS, line _ generate, line _ MONITORDIGITS, line _ MONITORTONE), afin de déterminer leur minutage relatif (séparation entre les événements). Le nombre de cycles peut « habiller » après environ 49,7 jours ; les applications doivent prendre cela en compte lors de l’exécution de calculs.

Si le fournisseur de services ne génère pas l’horodateur (par exemple, s’il a été créé à l’aide d’une version antérieure de TAPI), TAPI fournit un horodateur au point le plus proche du fournisseur de services qui génère l’événement afin que l’horodatage synthétisé soit le plus précis possible.

Spécifications

Condition requise Valeur
Version TAPI
Nécessite TAPI 2,0 ou une version ultérieure
En-tête
TAPI. h

Voir aussi

GATHERDIGITS de ligne _

générer la ligne _

MONITORDIGITS de ligne _

MONITORTONE de ligne _