LINEMONITORTONE, structure (tapi.h)

  • Article

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

Voir aussi

LINE_MONITORTONE

TSPI_lineMonitorTones

lineMonitorTones