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

Статья
03/08/2023

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

Синтаксис

LONG phoneDevSpecific(
  HPHONE hPhone,
  LPVOID lpParams,
  DWORD  dwSize
);

Параметры

hPhone

Обработка на телефонном устройстве.

lpParams

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

dwSize

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

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

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED PHONEERR_OPERATIONFAILED.

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

Эта операция предоставляет универсальный профиль параметров. Интерпретация блока параметров зависит от устройства. Указания и ответы, относящиеся к конкретному устройству, должны использовать сообщение PHONE_DEVSPECIFIC .

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