LINE_APPNEWCALL消息

TAPI LINE_APPNEWCALL 消息用于通知应用程序,如果已代表应用程序自发创建了一个新的调用句柄, (应用程序不是通过 API 调用创建,在这种情况下,句柄将通过传递到函数) 的指针参数返回。

        

parameters

hDevice

创建调用的线路设备的应用程序的句柄。

dwCallbackInstance

打开调用的线路时提供的回调实例。

dwParam1

显示呼叫的行上的地址标识符。 地址标识符与地址永久关联;标识符在操作系统升级中保持不变。

dwParam2

应用程序对新调用的句柄。

dwParam3

新调用的应用程序特权 (LINECALLPRIVILEGE_OWNER或LINECALLPRIVILEGE_MONITOR) 。

返回值

没有返回值。

备注

每当应用程序自发地获得新调用的句柄时,支持 TAPI 2.0 或更高版本的应用程序都会收到LINE_APPNEWCALL消息。 由于消息包含存在调用的 hLinedwAddressID 参数,因此应用程序可以轻松地在正确的上下文中创建新的调用对象。 LINE_APPNEWCALL消息始终紧跟LINE_CALLSTATE消息,指示调用的初始状态。

协商 API 版本早于 2.0) 的较旧应用程序 (,只会发送 LINE_CALLSTATE 消息,如 API 的早期版本中所述。 此类应用程序会在收到将 dwParam3 设置为非零值并包含应用程序目前不知道的调用句柄的LINE_CALLSTATE消息时创建新的调用对象。 缺点是 () 应用程序必须调用 lineGetCallInfo 来确定与调用关联的 hLinedwAddressID 参数; (b) 应用程序必须扫描所有已知的调用句柄,以确定该调用是否为新调用; (c) 在某些情况下,应用程序可能会认为它正在接收新的调用句柄,而实际上它刚刚将其句柄解除分配给调用 (例如,应用程序刚刚解除分配了调用句柄,但 LINE_CALLSTATE 消息(由于来自另一个应用程序的 lineHandoff 而授予应用程序呼叫所有权)已在应用程序的 TAPI 消息队列) 中。

要求

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

另请参阅

LINE_CALLSTATE

lineGetCallInfo

lineHandoff