LINE_MONITORTONE сообщение

Сообщение LINE_MONITORTONE TAPI отправляется при обнаружении сигнала. Отправка этого сообщения управляется функцией lineMonitorTones .

Параметры

hDevice

Дескриптор вызова.

dwCallbackInstance

Экземпляр обратного вызова, предоставленный при открытии строки вызова.

dwParam1

Элемент dwAppSpecific для конкретного приложения структуры LINEMONITORTONE для обнаруженного тона.

dwParam2

Не используется.

dwParam3

Число тактов (количество миллисекундах с момента запуска Windows), при котором был обнаружен тон. Для версий API, предшествующих 2.0, этот параметр не используется.

Возвращаемое значение

Нет возвращаемого значения.

Комментарии

Сообщение LINE_MONITORTONE отправляется только в приложение, которое запросило отслеживание тона.

Так как эта метка времени может быть создана на компьютере, отличном от того, на котором выполняется приложение, она полезна только для сравнения с другими аналогичными сообщениями, созданными на том же устройстве (LINE_GATHERDIGITS, LINE_GENERATE, LINE_MONITORDIGITS, LINE_MONITORTONE), чтобы определить их относительное время (разделение между событиями). Число тактов может "обернуться" примерно через 49,7 дня; приложения должны учитывать это при выполнении вычислений.

Если поставщик услуг не создает метку времени (например, если она была создана с помощью более ранней версии TAPI), ТО TAPI предоставляет метку времени в точке, ближайшей к поставщику услуг, создающей событие, чтобы синтезированные метки времени были максимально точными.

Требования

Требование	Значение
Версия TAPI	Требуется TAPI 2.0 или более поздней версии
Заголовок	Tapi.h

См. также раздел

LINE_GATHERDIGITS

LINE_GENERATE

LINE_MONITORDIGITS

LINEMONITORTONE

lineMonitorTones