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外，所有状态报告均处于禁用状态状态。 此消息将发送到具有行句柄的所有应用程序，包括调用 lineOpen 且 dwPrivileges 参数设置为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