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，如果發生錯誤，則傳回錯誤號碼。如果函式成功，則對應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。