Функция lineSetNumRings (tapi.h)

Статья
08/26/2023

Функция lineSetNumRings задает количество кругов, которые должны произойти до ответа на входящий вызов. Эту функцию можно использовать для реализации функции в стиле с сохранением платы. Это позволяет нескольким независимым приложениям регистрировать количество колец. Функция lineGetNumRings возвращает минимальное количество запрошенных колец. Он может использоваться приложением, которое отвечает на входящие звонки, чтобы определить количество звонков, которые следует ждать перед ответом на звонок.

Синтаксис

LONG lineSetNumRings(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwNumRings
);

Параметры

hLine

Дескриптор к устройству с открытой линией.

dwAddressID

Адрес на устройстве линии. Идентификатор адреса постоянно связан с адресом; идентификатор остается неизменным при обновлении операционной системы.

dwNumRings

Количество звонков до ответа на вызов, чтобы учитывать запросы на экономию платы от всех приложений.

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

Возвращает ноль, если запрос выполнен успешно, или отрицательный номер ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM LINEERR_UNINITIALIZED.

Функции lineGetNumRings и lineSetNumRings при их совместном использовании предоставляют механизм для поддержки реализации функций экономии платы в нескольких независимых приложениях. Если ни один из приложений не вызывает lineSetNumRings, функция lineGetNumRings возвращает 0xFFFFFFFF.

Приложение, которое является владельцем звонка в состоянии предложения и получило LINE_LINEDEVSTATEзвонящее сообщение, должно подождать количество колец, равное числу, возвращаемого lineGetNumRings , прежде чем отвечать на вызов, чтобы учитывать параметры экономии платы во всех приложениях. Отдельное LINE_LINEDEVSTATE звонящее сообщение отправляется приложению для каждого цикла кругов, поэтому приложение должно подсчитать эти сообщения. Если этот вызов отключается перед ответом, а вскоре после этого поступает еще один вызов, LINE_CALLSTATE сообщение должно позволить приложению определить, что звонок связан со вторым вызовом.

Если классификация вызовов выполняется TAPI с помощью ответа на входящие вызовы неизвестного типа мультимедиа и фильтрации потока мультимедиа, TAPI также учитывает этот номер.

Примечание Эта операция является исключительно информационной и не влияет на состояние каких-либо вызовов на устройстве линии.