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

Статья
08/26/2023

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

Синтаксис

LONG lineDevSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  HCALL  hCall,
  LPVOID lpParams,
  DWORD  dwSize
);

Параметры

hLine

Дескриптор на линейное устройство. Это обязательный параметр.

dwAddressID

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

hCall

Дескриптор вызова. Этот параметр является необязательным, но если он указан, вызов, который он представляет, должен принадлежать устройству линии hLine . Состояние вызова hCall зависит от устройства.

lpParams

Указатель на область памяти, используемую для хранения блока параметров. Формат этого блока параметров зависит от устройства, и его содержимое передается TAPI поставщику услуг или от него.

dwSize

Размер области блока параметров в байтах.

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

Возвращает положительный идентификатор запроса, если функция выполняется асинхронно, или отрицательный номер ошибки при возникновении ошибки. Параметр dwParam2 соответствующего сообщения LINE_REPLY равен нулю при успешном выполнении функции или отрицательным номером ошибки при возникновении ошибки. Возможные возвращаемые значения:

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

Дополнительные возвращаемые значения зависят от устройства.

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

Эта функция предоставляет универсальный профиль параметров. Интерпретация структуры параметров зависит от устройства. Указывает, должны ли dwAddressID и (или ) hCall быть допустимыми, зависит от устройства. Если они указаны, они должны принадлежать hLine. Указания и ответы, отправляемые приложению, которые относятся к конкретному устройству, должны использовать сообщение LINE_DEVSPECIFIC .

Поставщик услуг может предоставить доступ к функциям устройства, определив параметры для использования с этой функцией. Приложения, которые хотят использовать эти расширения для конкретного устройства, должны обратиться к документации по конкретному устройству (в данном случае к конкретному поставщику), в которой описывается, какие расширения определены. Как правило, приложение, использующее эти расширения для конкретного устройства, не может работать с другими средами поставщика услуг.

Осторожностью TAPI записывает возвращенные данные в буфер, на который ссылается lParam, при возвращении сообщения LINE_REPLY. Это означает, что буфер должен оставаться действительным до тех пор, пока не будет возвращено сообщение LINE_REPLY; В противном случае могут возникать повреждения данных и исключения.