lineSetCallQualityOfService 函式 (tapi.h)
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。
規格需求
目標平台 | Windows |
標頭 | tapi.h |
程式庫 | Tapi32.lib |
Dll | Tapi32.dll |