LINE_GATHERDIGITS消息

当当前缓冲的数字收集请求终止或取消时,将发送 TAPI LINE_GATHERDIGITS 消息。 应用程序收到此消息后,可以检查数字缓冲区。

            

parameters

hDevice

调用的句柄。

dwCallbackInstance

打开行时提供的回调实例。

dwParam1

数字收集被终止的原因。 此参数必须是一个且唯一 的LINEGATHERTERM_常量

dwParam2

未使用。

dwParam3

“刻度计数” (自 Windows 启动) 完成数字收集以来的毫秒数。 对于早于 2.0 的 TAPI 版本,此参数未使用。

返回值

没有返回值。

备注

LINE_GATHERDIGITS消息仅发送到使用 lineGatherDigits 在调用上发起数字收集的应用程序。

如果使用 lineGatherDigits 函数取消之前收集数字的请求,TAPI 会将 dwParam1 设置为 LINEGATHERTERM_CANCEL 的LINE_GATHERDIGITS消息发送到应用程序,指示最初指定的缓冲区包含收集到取消的数字。

由于 dwParam3 指定的时间戳可能是在应用程序所执行的计算机以外的计算机上生成的,因此,它仅用于比较同一行设备 ( LINE_GENERATELINE_MONITORDIGITSLINE_MONITORMEDIALINE_MONITORTONE) 的其他类似时间戳消息,以便确定事件) 之间的相对计时 (分隔。 时钟周期计数可以在大约 49.7 天后“环绕”:应用程序在执行计算时必须考虑到这一点。

例如,如果服务提供商未 (生成时间戳,则如果它是使用早期版本的 TAPI) 创建的,则 TAPI 在最靠近生成事件的服务提供商处提供时间戳,以便合成的时间戳尽可能准确。

注意

当应用程序调用将数据写回应用程序内存的任何异步操作时,应用程序必须保持该内存可供写入,直到收到 LINE_REPLYLINE_GATHERDIGITS 消息。

要求

要求
TAPI 版本
需要 TAPI 2.0 或更高版本
标头
Tapi.h

请参阅

LINE_GENERATE

LINE_MONITORDIGITS

LINE_MONITORMEDIA

LINE_MONITORTONE

LINE_REPLY

lineGatherDigits