TSPI_lineSetMediaMode函数 (tspi.h)

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 个) 如果设置了多个位,则还设置了“未知”。 服务提供商必须对媒体类型执行任何进一步的有效性检查,例如检查服务提供商是否确实支持任何媒体类型。

要求

要求
目标平台 Windows
标头 tspi.h

另请参阅

LINECALLINFO

LINEMEDIAMODE_常量

TSPI_lineGetCallInfo