сообщение LINE_GATHERDIGITS
Сообщение LINE_GATHERDIGITS TAPI отправляется при завершении или отмене текущего запроса на сбор цифр в буфере. Буфер цифр можно проверить после получения этого сообщения приложением.
Параметры
-
hDevice
-
Дескриптор вызова.
-
dwCallbackInstance
-
Экземпляр обратного вызова, предоставленный при открытии строки.
-
dwParam1
-
Причина, по которой сбор цифр был прерван. Этот параметр должен быть одной из констант LINEGATHERTERM_.
-
dwParam2
-
Не используется.
-
dwParam3
-
Число тактов (количество миллисекундах с момента запуска Windows), при котором сбор цифр завершен. Для версий TAPI, предшествующих 2.0, этот параметр не используется.
Возвращаемое значение
Нет возвращаемого значения.
Комментарии
Сообщение LINE_GATHERDIGITS отправляется только приложению, которое инициировало сбор цифр при вызове с помощью lineGatherDigits.
Если функция lineGatherDigits используется для отмены предыдущего запроса на сбор цифр, TAPI отправляет LINE_GATHERDIGITS сообщение с параметром dwParam1 для LINEGATHERTERM_CANCEL приложению, указывающее, что первоначально указанный буфер содержит цифры, собранные до отмены.
Поскольку метка времени, указанная dwParam3 , может быть создана на компьютере, отличном от того, на котором выполняется приложение, она полезна только для сравнения с другими аналогичными сообщениями, созданными на том же устройстве ( LINE_GENERATE, LINE_MONITORDIGITS, LINE_MONITORMEDIALINE_MONITORTONE), чтобы определить их относительное время (разделение между событиями). Число тактов может "обернуться" примерно через 49,7 дня; приложения должны учитывать это при выполнении вычислений.
Если поставщик услуг не создает метку времени (например, если она была создана с помощью более ранней версии TAPI), ТО TAPI предоставляет метку времени в точке, ближайшей к поставщику услуг, создающей событие, чтобы синтезированные метки времени были максимально точными.
Примечание
Когда приложение вызывает любую асинхронную операцию, которая записывает данные обратно в память приложения, приложение должно держать ее доступной для записи до получения сообщения LINE_REPLY или LINE_GATHERDIGITS .
Требования
| Требование | Значение |
|---|---|
| Версия TAPI |
Требуется TAPI 2.0 или более поздней версии |
| Заголовок |
|