TSPI_lineSetCallParams 函数 (tspi.h)

项目
08/26/2023

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 或错误号。如果函数成功，相应ASYNC_COMPLETION的 lResult 实际参数为零;如果发生错误，则为错误号。可能的返回值如下所示：

LINEERR_INVALCALLHANDLE、LINEERR_RATEUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_NOMEM、LINEERR_INVALBEARERMODE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALPOINTER、LINEERR_OPERATIONFAILED、LINEERR_INVALRATE、LINEERR_RESOURCEUNAVAIL、LINEERR_BEARERMODEUNAVAIL。