Estrutura LINEMEDIACONTROLTONE (tapi.h)
A estrutura LINEMEDIACONTROLTONE descreve uma ação de mídia a ser executada quando um tom é detectado. Ele é usado como uma entrada em uma matriz. As funções lineSetMediaControl e TSPI_lineSetMediaControl usam essa estrutura.
Sintaxe
typedef struct linemediacontroltone_tag {
DWORD dwAppSpecific;
DWORD dwDuration;
DWORD dwFrequency1;
DWORD dwFrequency2;
DWORD dwFrequency3;
DWORD dwMediaControl;
} LINEMEDIACONTROLTONE, *LPLINEMEDIACONTROLTONE;
Membros
dwAppSpecific
Usado pelo aplicativo para marcar o tom. Quando esse tom é detectado, o valor do membro dwAppSpecific é passado de volta para o aplicativo.
dwDuration
Duração do tempo durante o qual o tom deve estar presente antes que uma detecção seja feita, em milissegundos.
dwFrequency1
Primeira frequência do tom, em hertz.
dwFrequency2
Segunda frequência do tom, em hertz.
dwFrequency3
Terceira frequência do tom, em hertz. Se menos de três frequências forem necessárias no tom, um valor de 0 deverá ser usado para as frequências não utilizadas. Um tom com todas as três frequências definidas como zero é interpretado como silêncio e pode ser usado para detecção de silêncio.
dwMediaControl
Ação de controle de mídia. Esse membro usa uma das constantes LINEMEDIACONTROL_.
Comentários
Essa estrutura pode não ser estendida.
A estrutura LINEMEDIACONTROLTONE define um tom de tupla <, ação> de controle de mídia. Uma matriz dessas tuplas é passada para a função lineSetMediaControl para definir ações de controle de mídia disparadas por alterações de tipo de mídia para uma determinada chamada. Quando uma alteração em um tipo de mídia listado é detectada, a ação correspondente no fluxo de mídia é invocada.
Um tom com todas as frequências definidas como zero corresponde ao silêncio. Assim, um aplicativo pode monitorar o fluxo de informações da chamada para silêncio.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | tapi.h |