Estructura LINEMEDIACONTROLTONE (tapi.h)

La estructura LINEMEDIACONTROLTONE describe una acción multimedia que se va a ejecutar cuando se ha detectado un tono. Se usa como entrada en una matriz. Las funciones lineSetMediaControl y TSPI_lineSetMediaControl usan esta estructura.

Sintaxis

typedef struct linemediacontroltone_tag {
  DWORD dwAppSpecific;
  DWORD dwDuration;
  DWORD dwFrequency1;
  DWORD dwFrequency2;
  DWORD dwFrequency3;
  DWORD dwMediaControl;
} LINEMEDIACONTROLTONE, *LPLINEMEDIACONTROLTONE;

Miembros

dwAppSpecific

Lo usa la aplicación para etiquetar el tono. Cuando se detecta este tono, el valor del miembro dwAppSpecific se devuelve a la aplicación.

dwDuration

Duración del tiempo durante el cual el tono debe estar presente antes de que se realice una detección, en milisegundos.

dwFrequency1

Primera frecuencia del tono, en hercios.

dwFrequency2

Segunda frecuencia del tono, en hercios.

dwFrequency3

Tercera frecuencia del tono, en hercios. Si se necesitan menos de tres frecuencias en el tono, se debe usar un valor de 0 para las frecuencias no utilizadas. Un tono con las tres frecuencias establecidas en cero se interpreta como silencio y se puede usar para la detección de silencio.

dwMediaControl

Acción de control multimedia. Este miembro usa una de las constantes de LINEMEDIACONTROL_.

Comentarios

Es posible que esta estructura no se extienda.

La estructura LINEMEDIACONTROLTONE define un tono de tupla <y una acción> de control multimedia. Una matriz de estas tuplas se pasa a la función lineSetMediaControl para establecer acciones de control multimedia desencadenadas por cambios de tipo de medio para una llamada determinada. Cuando se detecta un cambio en un tipo de medio enumerado, se invoca la acción correspondiente en la secuencia multimedia.

Un tono con todas las frecuencias establecidas en cero corresponde al silencio. Por lo tanto, una aplicación puede supervisar el flujo de información de la llamada en busca de silencio.

Requisitos

Requisito	Valor
Header	tapi.h

Consulte también

TSPI_lineSetMediaControl

lineSetMediaControl