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

未使用。

返回值

没有返回值。

备注

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

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

要求

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

另请参阅

PHONE_CLOSE

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneOpen

phoneSetStatusMessages

phoneShutdown