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 |