Estrutura LINEMONITORTONE (tapi.h)

  • Artigo

A estrutura LINEMONITORTONE descreve um tom a ser monitorado. Isso é usado como uma entrada em uma matriz. As funções lineMonitorTones e TSPI_lineMonitorTones usam essa estrutura.

Sintaxe

typedef struct linemonitortone_tag {
  DWORD dwAppSpecific;
  DWORD dwDuration;
  DWORD dwFrequency1;
  DWORD dwFrequency2;
  DWORD dwFrequency3;
} LINEMONITORTONE, *LPLINEMONITORTONE;

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.

Comentários

Essa estrutura pode não ser estendida.

A estrutura LINEMONITORTONE define um tom para fins de detecção. Uma matriz de tons é passada para a função lineMonitorTones que monitora esses tons e envia uma mensagem LINE_MONITORTONE para o aplicativo quando uma detecção é feita.

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 em busca de silêncio.

Requisitos

Requisito Valor
Cabeçalho tapi.h

Confira também

LINE_MONITORTONE

TSPI_lineMonitorTones

lineMonitorTones