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值，指定 hookswitch 已轉換的狀態。 只有在 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方法會傳回長值，指定手機轉換的通道模式。 只有在 ITPhoneEvent：：get_Event 方法傳回PE_RINGMODE時，才能使用這項資訊。

需求

目標平台	Windows
標頭	tapi3if.h (包括 Tapi3.h)