LINE_APPNEWCALL消息
TAPI LINE_APPNEWCALL 消息用于通知应用程序,如果已代表应用程序自发创建了一个新的调用句柄, (应用程序不是通过 API 调用创建,在这种情况下,句柄将通过传递到函数) 的指针参数返回。
parameters
-
hDevice
-
创建调用的线路设备的应用程序的句柄。
-
dwCallbackInstance
-
打开调用的线路时提供的回调实例。
-
dwParam1
-
显示呼叫的行上的地址标识符。 地址标识符与地址永久关联;标识符在操作系统升级中保持不变。
-
dwParam2
-
应用程序对新调用的句柄。
-
dwParam3
-
新调用的应用程序特权 (LINECALLPRIVILEGE_OWNER或LINECALLPRIVILEGE_MONITOR) 。
返回值
没有返回值。
备注
每当应用程序自发地获得新调用的句柄时,支持 TAPI 2.0 或更高版本的应用程序都会收到LINE_APPNEWCALL消息。 由于消息包含存在调用的 hLine 和 dwAddressID 参数,因此应用程序可以轻松地在正确的上下文中创建新的调用对象。 LINE_APPNEWCALL消息始终紧跟LINE_CALLSTATE消息,指示调用的初始状态。
协商 API 版本早于 2.0) 的较旧应用程序 (,只会发送 LINE_CALLSTATE 消息,如 API 的早期版本中所述。 此类应用程序会在收到将 dwParam3 设置为非零值并包含应用程序目前不知道的调用句柄的LINE_CALLSTATE消息时创建新的调用对象。 缺点是 () 应用程序必须调用 lineGetCallInfo 来确定与调用关联的 hLine 和 dwAddressID 参数; (b) 应用程序必须扫描所有已知的调用句柄,以确定该调用是否为新调用; (c) 在某些情况下,应用程序可能会认为它正在接收新的调用句柄,而实际上它刚刚将其句柄解除分配给调用 (例如,应用程序刚刚解除分配了调用句柄,但 LINE_CALLSTATE 消息(由于来自另一个应用程序的 lineHandoff 而授予应用程序呼叫所有权)已在应用程序的 TAPI 消息队列) 中。
要求
要求 | 值 |
---|---|
TAPI 版本 |
需要 TAPI 2.0 或更高版本 |
标头 |
|