lineSetCallQualityOfService 函式 (tapi.h)

發行項
03/08/2023

lineSetCallQualityOfService函式可讓應用程式嘗試變更服務參數的品質， (保留容量和效能保證) 現有的呼叫。除了基本參數驗證之外，這是直接傳遞至服務提供者。

語法

LONG lineSetCallQualityOfService(
  HCALL  hCall,
  LPVOID lpSendingFlowspec,
  DWORD  dwSendingFlowspecSize,
  LPVOID lpReceivingFlowspec,
  DWORD  dwReceivingFlowspecSize
);

參數

hCall

呼叫的控制碼。應用程式必須具有 OWNER 許可權。

lpSendingFlowspec

包含 FLOWSPEC 結構的記憶體指標，後面接著提供者特定的資料。 在 FLOWSPEC結構後面的提供者特定部分不得包含應用程式進程中其他記憶體區塊的指標，因為 TAPI 不會知道如何封送處理私人指標所指向的資料， (s) ，並透過與服務提供者之間的通訊來傳達它。

dwSendingFlowspecSize

FLOWSPEC結構和隨附提供者特定資料的大小總計，以位元組為單位。這相當於在 QOS結構中的SendingFlowspec中儲存的內容。

lpReceivingFlowspec

包含 FLOWSPEC 結構的記憶體指標，後面接著提供者特定的資料。在 FLOWSPEC結構後面的提供者特定部分不得包含應用程式進程中其他記憶體區塊的指標，因為 TAPI 不會知道如何封送處理私人指標所指向的資料， (s) ，並透過與服務提供者之間的通訊來傳達它。

dwReceivingFlowspecSize

FLOWSPEC和隨附提供者特定資料的大小總計，以位元組為單位。這相當於QOS結構中儲存在 ReceivingFlowspec中的專案。

傳回值

如果非同步作業啟動，則傳回正要求識別碼;否則，函式會傳回下列其中一個負誤差值：

LINEERR_INVALCALLHANDLE、LINEERR_INVALCALLSTATE、LINEERR_INVALPARAM、LINEERR_INVALPOINTER、LINEERR_INVALRATE、LINEERR_NOMEM、LINEERR_NOTOWNER、LINEERR_OPERATIONUNAVAIL、LINEERR_OPERATIONFAILED、LINEERR_RATEUNAVAIL、LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED。