TSPI_lineSetDefaultMediaDetection 函数 (tspi.h)

项目
03/03/2024

TSPI_lineSetDefaultMediaDetection过程告知服务提供商要检测的指示行的新媒体类型集， (替换之前设置的任何) 。它还设置在后续调用 (此行的入站或出站) 时应监视的初始媒体类型集。

语法

LONG TSPIAPI TSPI_lineSetDefaultMediaDetection(
  HDRVLINE hdLine,
  DWORD    dwMediaModes
);

参数

hdLine

要设置媒体监视的行的句柄。

dwMediaModes

媒体类型 (TAPI 感兴趣的) 。此参数使用 LINEMEDIAMODE_常量之一：

返回值

如果函数成功，则返回零;如果发生错误，则返回错误号。可能的返回值如下所示：

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALMEDIAMODE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_NODRIVER、LINEERR_OPERATIONUNAVAIL。

注解

TAPI 通常调用此函数，以便每当某行在 TAPI 级别打开或关闭时，将行的检测到的一组媒体类型更新为所有未完成的 lineOpens 选择的所有模式的并集。如果媒体检测被拒绝，将拒绝 lineOpen 调用尝试。对此过程的单个调用通常是不指定设备标识符 LINEMAPPER 的 lineOpen 调用的结果。设备标识符 LINEMAPPER 永远不会在 TSPI 级别使用。

TAPI 必须计算所有客户端所需的媒体类型的联合，并将结果传递给此函数。服务提供商使用 TAPI 传递给此函数的集。 TAPI 确保 dwMediaModes 参数至少设置了一个位，并且未设置保留位。服务提供商必须对媒体类型执行任何进一步的有效性检查，例如检查服务提供商是否确实支持任何媒体类型。如果打开线路的应用程序都是监视器，或者对处理传入调用不感兴趣，则所有媒体类型的联合可以为值 0。

TAPI 级别没有直接对应的函数。此过程对应于使用 LINEMAPPER) 以外的特定设备标识符 (调用 lineOpen 过程为特定行隐含的“请求媒体类型”。