itPhoneEvent 接口 (tapi3if.h)

ITPhoneEvent 接口包含检索已发生的电话事件说明的方法。 当应用程序的 ITTAPIEventNotification：：Event 方法的实现指示TAPI_EVENT等于TE_PHONEEVENT时，该方法的 pEvent 参数是 ITPhoneEvent 接口的 IDispatch 指针。

注意 必须调用 ITTAPI：:p ut_EventFilter 方法并设置包含 TE_PHONEEVENT 的事件筛选器掩码，以便接收电话事件。 如果不调用 ITTAPI：:p ut_EventFilter，应用程序将不会收到任何事件。 有关详细信息，请参阅 事件 概述。

 

继承

ITPhoneEvent 接口继承自 IDispatch 接口。 ITPhoneEvent 还具有以下类型的成员：

方法

ITPhoneEvent 接口具有这些方法。

ITPhoneEvent：：get_ButtonLampId get_ButtonLampId 方法返回一个长值，指示哪个按钮或灯触发了事件。 仅当 ITPhoneEvent：：get_Event 返回PE_LAMPMODE或PE_BUTTON时，此信息才可用。
ITPhoneEvent：：get_ButtonState get_ButtonState 方法返回一个PHONE_BUTTON_STATE值，该值指定按钮转换到的状态。 仅当 ITPhoneEvent：：get_Event 方法返回PE_BUTTON时，此信息才可用。
ITPhoneEvent：：get_Call get_Call 方法返回指向事件中涉及的调用对象的 ITCallInfo 接口的指针。
ITPhoneEvent：：get_Event get_Event 方法返回一个PHONE_EVENT值，该值指定发生的电话事件类型。
ITPhoneEvent：：get_HookSwitchDevice get_HookSwitchDevice 方法返回一个PHONE_HOOK_SWITCH_DEVICE值，该值指定更改了状态的挂钩开关设备。 仅当 ITPhoneEvent：：get_Event 方法返回PE_HOOKSWITCH时，此信息才可用。
ITPhoneEvent：：get_HookSwitchState get_HookSwitchState 方法返回一个PHONE_HOOK_SWITCH_STATE值，该值指定挂钩开关转换到的状态。 仅当 ITPhoneEvent：：get_Event 方法返回PE_HOOKSWITCH时，此信息才可用。
ITPhoneEvent：：get_NumberGathered get_NumberGathered 方法返回一个 BSTR 值，该值指定收集的电话号码。 仅当 ITPhoneEvent：：get_Event 方法返回PE_NUMBERGATHERED时，此信息才可用。
ITPhoneEvent：：get_Phone get_Phone 方法返回指向触发此事件的电话对象上的 ITPhone 接口的指针。
ITPhoneEvent：：get_RingMode get_RingMode 方法返回一个 long 值，该值指定手机已转换到的响铃模式。 仅当 ITPhoneEvent：：get_Event 方法返回PE_RINGMODE时，此信息才可用。

要求

目标平台	Windows
标头	tapi3if.h (包括 Tapi3.h)