функция lineGetNumRings (tapi.h)

Статья
07/16/2024

Функция lineGetNumRings определяет количество звонков, входящих вызовов по указанному адресу, прежде чем отвечать на вызов.

Синтаксис

LONG lineGetNumRings(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPDWORD lpdwNumRings
);

Параметры

hLine

Обработайте устройство открытой строки.

dwAddressID

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

lpdwNumRings

Количество кругов, которое является минимальным из всех текущих запросов lineSetNumRings.

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

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

LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Замечания

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

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

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

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

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

Справочник по службам базовой телефонии

LINE_LINEDEVSTATE

Обзор TAPI 2.2

lineSetNumRings

Поделиться через