Partager via


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

Voir aussi

TSPI_lineSetMediaControl

lineSetMediaControl