STRUCTURE LINEMEDIACONTROLTONE (tapi.h)
La structure LINEMEDIACONTROLTONE décrit une action multimédia à exécuter lorsqu’un ton a été détecté. Il est utilisé comme entrée dans un tableau. Les fonctions lineSetMediaControl et TSPI_lineSetMediaControl utilisent cette structure.
Syntaxe
typedef struct linemediacontroltone_tag {
DWORD dwAppSpecific;
DWORD dwDuration;
DWORD dwFrequency1;
DWORD dwFrequency2;
DWORD dwFrequency3;
DWORD dwMediaControl;
} LINEMEDIACONTROLTONE, *LPLINEMEDIACONTROLTONE;
Membres
dwAppSpecific
Utilisé par l’application pour marquer le ton. Lorsque ce ton est détecté, la valeur du membre dwAppSpecific est renvoyée à l’application.
dwDuration
Durée pendant laquelle le ton doit être présent avant qu’une détection soit effectuée, en millisecondes.
dwFrequency1
Première fréquence du ton, en hertz.
dwFrequency2
Deuxième fréquence de la tonalité, en hertz.
dwFrequency3
Troisième fréquence du ton, en hertz. Si moins de trois fréquences sont nécessaires dans le ton, une valeur de 0 doit être utilisée pour les fréquences inutilisées. Un ton avec les trois fréquences définies sur zéro est interprété comme silence et peut être utilisé pour la détection du silence.
dwMediaControl
Action de contrôle multimédia. Ce membre utilise l’une des constantes LINEMEDIACONTROL_.
Remarques
Cette structure peut ne pas être étendue.
La structure LINEMEDIACONTROLTONE définit une tonalité tuple <, une action> de contrôle multimédia. Un tableau de ces tuples est passé à la fonction lineSetMediaControl pour définir des actions de contrôle multimédia déclenchées par les modifications de type de média pour un appel donné. Lorsqu’une modification d’un type de média répertorié est détectée, l’action correspondante sur le flux multimédia est appelé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 pour le silence.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | tapi.h |