TSPI_lineSetMediaMode函式 (tspi.h)

發行項
03/13/2024

TSPI_lineSetMediaMode函式會將呼叫的媒體變更為儲存在呼叫的LINECALLINFO結構中。

語法

LONG TSPIAPI TSPI_lineSetMediaMode(
  HDRVCALL hdCall,
  DWORD    dwMediaMode
);

參數

hdCall

進行媒體類型變更之呼叫的句柄。 hdCall 的呼叫狀態可以是任何狀態。

dwMediaMode

新的媒體類型 (呼叫的) 。只要設定LINEMEDIAMODE_UNKNOWN媒體類型旗標，也可以設定多個其他媒體類型旗標。這可用來識別呼叫的媒體類型不完全判斷，但縮小為一小部分的指定媒體類型之一。如果未設定LINEMEDIAMODE_UNKNOWN旗標，則只能指定單一媒體類型。此參數使用一 (或多個 LINEMEDIAMODE_常數的) 。

傳回值

如果函式成功，則傳回零，如果發生錯誤，則傳回錯誤號碼。可能的傳回值如下所示：

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALMEDIAMODE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL。

備註

除了將呼叫的媒體變更為儲存在呼叫的 LINECALLINFO 結構之外，此程式只是表示它表示即將發生的預期媒體變更，而不是強制對呼叫進行特定的變更。一般用法是將呼叫的媒體類型設定為特定的已知媒體類型，或只要呼叫的媒體類型不是完全已知的媒體類型， (未知媒體類型旗標設定為) ，就可以排除可能的媒體類型。

TAPI 會針對傳遞的媒體類型做出下列保證： (1) 至少有一個位集， (2) 沒有保留位集，如果設定多個位， (3) ，也會設定 “Unknown”。服務提供者必須在媒體類型上執行任何進一步的有效檢查，例如檢查服務提供者是否確實支援任何媒體類型。