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。