PHONE_STATE消息

每当电话设备的状态发生更改时,TAPI 会将 PHONE_STATE 消息发送到应用程序。

            

参数

hPhone

电话设备的句柄。

dwCallbackInstance

打开电话设备时提供的应用程序回调实例。

dwParam1

已更改的电话状态。 此参数使用 PHONESTATE_常量之一。

dwParam2

详细说明状态更改的电话状态相关信息。 如果在 dwParam1 中设置了多个标志,则不使用此参数,因为多个状态项已更改。 应用程序应调用 phoneGetStatus 以获取一组完整的信息。

如果 dwParam1 是PHONESTATE_OWNER, 则 dwParam2 包含新的所有者数。

如果 dwParam1 是PHONESTATE_MONITORS, 则 dwParam2 包含新的监视器数。

如果 dwParam1 是PHONESTATE_LAMP, 则 dwParam2 包含已更改的灯的按钮/灯标识符。

如果 dwParam1 是PHONESTATE_RINGMODE, 则 dwParam2 将包含新的环形模式。

如果 dwParam1 PHONESTATE_HANDSET、SPEAKER 或 HEADSET, dwParam2 将包含该挂钩开关设备的新 hookswitch 模式。 此参数使用 PHONEHOOKSWITCHMODE_常量之一。

dwParam3

未使用。

返回值

没有返回值。

备注

可以使用 phoneSetStatusMessagesphoneGetStatusMessages 控制和查询将PHONE_STATE消息发送到应用程序。 默认情况下,对于所有状态更改(PHONESTATE_REINIT除外)禁用此消息,无法禁用。 此消息将发送到具有电话句柄的所有应用程序,包括那些调用 phoneOpendwPrivileges 参数设置为 PHONEPRIVILEGE_OWNER 或 PHONEPRIVILEGE_MONITOR的应用程序。

带有“所有者”和/或“监视器”指示的 PHONE_STATE 消息将发送到已有电话句柄的应用程序。 这可以是另一个应用程序使用 phoneOpenphoneClosephoneShutdown 更改手机设备的所有权或监视范围的结果。

要求

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

另请参阅

PHONE_CLOSE

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneOpen

phoneSetStatusMessages

phoneShutdown