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