LINE_GENERATE 消息
发送 TAPI LINE\_GENERATE 消息,通知应用程序当前数字或音调生成已终止。 在给定的调用中,任何时候都只能有一个这样的生成请求正在进行中。 数字或音调生成取消时,也会发送此消息。
参数
-
hDevice
-
调用的句柄。
-
dwCallbackInstance
-
打开线路时提供的回调实例。
-
dwParam1
-
数字或音调生成终止的原因。 此参数必须是唯一一个 LINEGENERATETERM_ 常量。
-
dwParam2
-
未使用。
-
dwParam3
-
数字或音调生成完成时的“时钟周期计数”(自 Windows 启动以来的毫秒数)。 在低于 2.0 的 API 版本中,此参数未使用。
返回值
无返回值。
备注
LINE_GENERATE 消息仅发送到已请求数字或音调生成的应用程序。
由于 dwParam3 指定的时间戳可能是在执行应用程序的计算机以外的计算机上生成的,因此它仅用于与同一线路设备(LINE_GATHERDIGITS、LINE_MONITORDIGITS、LINE_MONITORMEDIA、LINE_MONITORTONE)上生成的其他类似时间戳消息进行比较,以确定它们的相对时间(事件之间的间隔)。 时钟周期计数可能会在大约 49.7 天后“回绕”;应用程序在执行计算时必须考虑到这一点。
如果服务提供商不生成时间戳(例如,它是使用早期版本的 TAPI 创建的),则 TAPI 会在最接近服务提供商生成事件的时间点提供时间戳,以便合成的时间戳尽可能准确。
要求
要求 | 值 |
---|---|
TAPI 版本 |
需要 TAPI 2.0 或更高版本 |
Header |
|