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

Статья
03/03/2024

Функция TSPI_lineSetCallParams задает определенные параметры для существующего вызова.

Синтаксис

LONG TSPIAPI TSPI_lineSetCallParams(
  DRV_REQUESTID          dwRequestID,
  HDRVCALL               hdCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

Параметры

dwRequestID

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

hdCall

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

dwBearerMode

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

dwMinRate

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

dwMaxRate

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

lpDialParams

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

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

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

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

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