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

Статья
08/26/2023

Функция lineSetCallParams позволяет приложению изменять режим носителя и /или параметры скорости существующего вызова.

Синтаксис

LONG lineSetCallParams(
  HCALL                  hCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

Параметры

hCall

Дескриптор вызова, параметры которого необходимо изменить. Приложение должно быть владельцем вызова. Состояние вызова hCall может быть любым, кроме состояния простоя или отключения.

dwBearerMode

Новый режим носителя для вызова. Этот параметр использует одну и только одну из констант LINEBEARERMODE_.

dwMinRate

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

dwMaxRate

Верхняя граница новой скорости передачи данных вызова. Это максимальная скорость передачи данных, доступная приложению. Если требуется точная скорость передачи данных, dwMinRate и dwMaxRate должны быть равными.

lpDialParams

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

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

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

LINEERR_BEARERMODEUNAVAIL, LINEERR_NOTOWNER, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RATEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALRATE, LINEERR_UNINITIALIZED LINEERR_NOMEM.

Эта операция используется для изменения параметров существующего вызова. Примеры его использования включают изменение режима носителя и (или) скорости передачи данных существующего вызова.