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 |