lineMonitorDigits 函数 (tapi.h)

项目
03/05/2024

lineMonitorDigits 函数启用和禁用对调用中收到的数字的无缓冲区检测。每次检测到指定数字模式的一个数字时，都会向应用程序发送一条消息，指示已检测到哪个数字。

语法

LONG lineMonitorDigits(
  HCALL hCall,
  DWORD dwDigitModes
);

参数

hCall

要检测到数字的调用的句柄。 hCall 的调用状态可以是空闲或断开连接之外的任何状态。

dwDigitModes

要监视的数字模式。如果 dwDigitModes 为零，则取消数字监视。此参数使用一个或多个 LINEDIGITMODE_常量。

返回值

如果请求成功，则返回零;如果发生错误，则返回负错误号。可能的返回值为：

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALDIGITMODE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

注解

如果数字监视已正确启动，则此函数被视为成功，而不是数字监视已终止。数字监视将一直有效，直到通过调用将 dwDigitModes 设置为零的 lineMonitorDigits 显式禁用，直到调用转换为空闲，或者应用程序解除分配调用的调用句柄。尽管可以在任何调用状态下调用此函数，但通常仅在调用处于连接状态时才检测到数字。

每次检测到数字时，都会向应用程序发送一条LINE_MONITORDIGITS消息，将检测到的数字作为参数传递。

应用程序可以使用 lineMonitorDigits 启用或禁用无缓冲区数字检测。它可以使用 lineGatherDigits 进行缓冲数字检测。缓冲数字收集完成后，会将LINE_GATHERDIGITS 消息发送到应用程序。可以在同一调用上同时启用缓冲和无缓冲数字检测。

对电话会议数字的监视仅适用于 hConfCall，不适用于单个参与呼叫。