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 или более поздней версии |
Заголовок |
|