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 或更高版本 |
标头 |
|