LINEMONITORTONE, structure (tapi.h)
La structure LINEMONITORTONE décrit une tonalité à surveiller. Il s’agit d’une entrée dans un tableau. Les fonctions lineMonitorTones et TSPI_lineMonitorTones utilisent cette structure.
Syntaxe
typedef struct linemonitortone_tag {
DWORD dwAppSpecific;
DWORD dwDuration;
DWORD dwFrequency1;
DWORD dwFrequency2;
DWORD dwFrequency3;
} LINEMONITORTONE, *LPLINEMONITORTONE;
Membres
dwAppSpecific
Utilisé par l’application pour baliser la tonalité. Lorsque cette tonalité est détectée, la valeur du membre dwAppSpecific est renvoyée à l’application.
dwDuration
Durée pendant laquelle la tonalité doit être présente avant qu’une détection soit effectuée, en millisecondes.
dwFrequency1
Première fréquence de la tonalité, en hertz.
dwFrequency2
Deuxième fréquence de la tonalité, en hertz.
dwFrequency3
Troisième fréquence de la tonalité, en hertz. Si moins de trois fréquences sont nécessaires dans la tonalité, la valeur 0 doit être utilisée pour les fréquences inutilisées. Une tonalité avec les trois fréquences définies sur zéro est interprétée comme un silence et peut être utilisée pour la détection du silence.
Remarques
Cette structure peut ne pas être étendue.
La structure LINEMONITORTONE définit une tonalité à des fins de détection. Un tableau de tonalités est passé à la fonction lineMonitorTones qui surveille ces tonalités et envoie un message LINE_MONITORTONE à l’application lorsqu’une détection est effectuée.
Une tonalité avec toutes les fréquences définies sur zéro correspond au silence. Une application peut ainsi surveiller le flux d’informations de l’appel à la recherche de silence.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | tapi.h |