Структура LINEMONITORTONE (tapi.h)

Статья
03/02/2024

Структура LINEMONITORTONE описывает тон, который необходимо отслеживать. Используется в качестве записи в массиве. Эта структура используется в функциях lineMonitorTones и TSPI_lineMonitorTones .

Синтаксис

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

Члены

dwAppSpecific

Используется приложением для добавления тегов к звуковому сигналу. При обнаружении этого сигнала значение члена dwAppSpecific передается обратно в приложение.

dwDuration

Продолжительность времени, в течение которого должен присутствовать тон перед выполнением обнаружения в миллисекундах.

dwFrequency1

Первая частота тона, в герцах.

dwFrequency2

Вторая частота тона, в герц.

dwFrequency3

Третья частота тона, в герц. Если в тон требуется менее трех частот, для неиспользуемых частот следует использовать значение 0. Тон со всеми тремя частотами, равными нулю, интерпретируется как тишина и может использоваться для обнаружения тишины.

Структура LINEMONITORTONE определяет тон для целей обнаружения. Массив тонов передается функции lineMonitorTones , которая отслеживает эти тона и отправляет LINE_MONITORTONE сообщение приложению при обнаружении.

Тон со всеми частотами, равными нулю, соответствует тишине. Таким образом, приложение может отслеживать информационный поток вызова для тишины.