LINE_LINEDEVSTATE消息

当线路设备的状态发生更改时,将发送 TAPI LINE_LINEDEVSTATE 消息。 应用程序可以调用 lineGetLineDevStatus 来确定行的新状态。

            

参数

hDevice

线路设备的句柄。 LINEDEVSTATE_REINIT dwParam1 时,此参数为 NULL

dwCallbackInstance

打开行时提供的回调实例。 如果 dwParam1 参数LINEDEVSTATE_REINIT,则 dwCallbackInstance 参数无效,并且设置为零。

dwParam1

已更改的行设备状态项。 参数可以是一个或多个 LINEDEVSTATE_常量

dwParam2

此参数的解释取决于 dwParam1 的值。 如果 dwParam1 LINEDEVSTATE_RINGING, 则 dwParam2 包含开关用于指示线路响铃的环形模式。 有效的环形模式是介于 1 到 dwNumRingModes 的范围内的数字,其中 dwNumRingModes 是线路设备功能。

如果 dwParam1 LINEDEVSTATE_REINIT,并且由于将新的 API 消息转换为 REINIT 消息而由 TAPI 发出,则 dwParam2 包含原始消息 (的 dwMsg 参数,例如 ,LINE_CREATE 或LINE_LINEDEVSTATE) 。 如果 dwParam2 为零,则表示 REINIT 消息是“真实”的 REINIT 消息,需要应用程序在方便时尽早调用 lineShutdown

dwParam3

此参数的解释取决于 dwParam1 的值。 如果 dwParam1 LINEDEVSTATE_RINGING, 则 dwParam3 包含此环事件的环计数。 环计数从零开始。

如果 dwParam1 LINEDEVSTATE_REINIT,并且由于将新 API 消息转换为 REINIT 消息而由 TAPI 发出,则 dwParam3 包含原始消息的 dwParam1 参数 (例如,LINEDEVSTATE_TRANSLATECHANGE或其他LINEDEVSTATE_值(如果 dwParam2 LINE_LINEDEVSTATE)或新的设备标识符, 如果 dwParam2为LINE_CREATE) ,则为 。

返回值

没有返回值。

备注

可以使用 lineSetStatusMessages 控制LINE_LINEDEVSTATE消息的发送。 应用程序可以指示要通知的状态项更改。 默认情况下,除无法禁用LINEDEVSTATE_REINIT外,所有状态报告均处于禁用状态状态。 此消息将发送到具有行句柄的所有应用程序,包括调用 lineOpendwPrivileges 参数设置为LINECALLPRIVILEGE_NONE、LINECALLPRIVILEGE_OWNER、LINECALLPRIVILEGE_MONITOR或允许的组合的应用程序。

要求

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

另请参阅

LINE_CLOSE

LINE_CREATE

LINEDEVCAPS

lineGetDevCaps

lineGetDevConfig

lineGetTranslateCaps

lineInitialize

lineOpen

lineSetStatusMessages

lineShutdown

LINETRANSLATECAPS

lineUncompleteCall