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

функция TSPI_lineDevSpecific (tspi.h)

  • Статья

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

Синтаксис

LONG TSPIAPI TSPI_lineDevSpecific(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HDRVCALL      hdCall,
  LPVOID        lpParams,
  DWORD         dwSize
);

Параметры

dwRequestID

Идентификатор асинхронного запроса.

hdLine

Дескриптор поставщика услуг к строке, с которой выполняется эксплуатация.

dwAddressID

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

hdCall

Дескриптор поставщика услуг для вызова, с которым выполняется работа. Это поле может иметь значение NULL. Состояние вызова hdCall зависит от устройства.

lpParams

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

dwSize

Размер области блока параметра в байтах. Если параметр lpParams является указателем на строку, размер должен включать признак конца null .

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

Возвращает dwRequestID или номер ошибки при возникновении ошибки. Фактический параметр lResult соответствующего ASYNC_COMPLETION равен нулю при успешном выполнении функции или номеру ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL.

Комментарии

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

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

Эта функция вызывается в прямом ответе на приложение, вызывающее функцию TAPI lineDevSpecific. TAPI преобразует параметры hLine и hdCall , используемые на уровне TAPI, в соответствующие параметры hdLine и hdCall , используемые на уровне TSPI. Буфер lpParams передается без изменений.

Примечание Структура данных lpParams не должна содержать указателей, так как они не будут правильно преобразованы (преобразовываются) при запуске 16-разрядного приложения в 32-разрядной версии TAPI и наоборот.
 
Поставщик услуг может предоставить доступ к функциям конкретного устройства, определив параметры для использования с этой операцией. Приложениям, которые хотят использовать эти расширения для конкретного устройства, следует обратиться к документации по конкретному устройству (в данном случае это относится к конкретному поставщику), в которой описывается, какие расширения определены.
Примечание Приложение, использующее расширения для конкретного устройства, не переносится при работе с другими средами поставщика услуг. Используйте расширения для конкретных поставщиков.
 
Эта операция является частью служб расширенной телефонии. Он предоставляет доступ только к функции конкретного устройства, не определяя ее значение. Эта операция доступна только в том случае, если приложение успешно согласовалось и выбрало версию расширения для конкретного устройства.

Требования

Требование Значение
Целевая платформа Windows
Header tspi.h

См. также раздел

ASYNC_COMPLETION

LINE_DEVSPECIFIC

TSPI_lineNegotiateExtVersion