lineSetCallParams 函数 (tapi.h)

项目
03/02/2024

lineSetCallParams 函数允许应用程序更改持有者模式和/或现有调用的速率参数。

语法

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

参数

hCall

要更改其参数的调用的句柄。应用程序必须是调用的所有者。 hCall 的调用状态可以是空闲或断开连接以外的任何状态。

dwBearerMode

调用的新持有者模式。此参数使用一个且只使用一个 LINEBEARERMODE_常量。

dwMinRate

调用的新数据速率的下限。应用程序可以接受新速率，最低为此速率。

dwMaxRate

调用的新数据速率的上限。这是应用程序可以接受的最大数据速率。如果需要确切的数据速率， dwMinRate 和 dwMaxRate 应相等。

lpDialParams

指向调用的新拨号参数的指针，类型为 LINEDIALPARAMS。如果要使用呼叫的当前拨号参数，此参数可以保留 为 NULL 。

返回值

如果异步完成函数，则返回正请求标识符;如果发生错误，则返回负错误号。如果函数成功，则相应LINE_REPLY消息的 dwParam2 参数为零;如果发生错误，则为负错误数。可能的返回值为：

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。