Compartilhar via


Interface ITPhoneEvent (tapi3if.h)

A interface ITPhoneEvent contém métodos que recuperam a descrição dos eventos de telefone que ocorreram. Quando a implementação do aplicativo do método ITTAPIEventNotification::Event indica uma TAPI_EVENT igual a TE_PHONEEVENT, o parâmetro pEvent do método é um ponteiro IDispatch para a interface ITPhoneEvent .

Nota Você deve chamar o método ITTAPI::p ut_EventFilter e definir uma máscara de filtro de evento que inclua TE_PHONEEVENT para habilitar a recepção de eventos de telefone. Se você não chamar ITTAPI::p ut_EventFilter, seu aplicativo não receberá nenhum evento. Para obter mais informações, consulte a Visão geral de eventos .
 

Herança

A interface ITPhoneEvent herda da interface IDispatch . ITPhoneEvent também tem estes tipos de membros:

Métodos

A interface ITPhoneEvent tem esses métodos.

 
ITPhoneEvent::get_ButtonLampId

O método get_ButtonLampId retorna um valor longo que indica qual botão ou lâmpada disparou o evento. Essas informações só estão disponíveis quando ITPhoneEvent::get_Event retorna PE_LAMPMODE ou PE_BUTTON.
ITPhoneEvent::get_ButtonState

O método get_ButtonState retorna um valor PHONE_BUTTON_STATE especificando o estado para o qual o botão fez a transição. Essas informações só estão disponíveis quando o método ITPhoneEvent::get_Event retorna PE_BUTTON.
ITPhoneEvent::get_Call

O método get_Call retorna um ponteiro para a interface ITCallInfo para o objeto de chamada envolvido no evento.
ITPhoneEvent::get_Event

O método get_Event retorna um valor PHONE_EVENT especificando o tipo de evento de telefone que ocorreu.
ITPhoneEvent::get_HookSwitchDevice

O método get_HookSwitchDevice retorna um valor PHONE_HOOK_SWITCH_DEVICE especificando o dispositivo hookswitch que alterou o estado. Essas informações só estão disponíveis quando o método ITPhoneEvent::get_Event retorna PE_HOOKSWITCH.
ITPhoneEvent::get_HookSwitchState

O método get_HookSwitchState retorna um valor PHONE_HOOK_SWITCH_STATE especificando o estado para o qual o hookswitch fez a transição. Essas informações só estão disponíveis quando o método ITPhoneEvent::get_Event retorna PE_HOOKSWITCH.
ITPhoneEvent::get_NumberGathered

O método get_NumberGathered retorna um valor BSTR especificando o número de telefone que foi coletado. Essas informações só estão disponíveis quando o método ITPhoneEvent::get_Event retorna PE_NUMBERGATHERED.
ITPhoneEvent::get_Phone

O método get_Phone retorna um ponteiro para a interface ITPhone no objeto de telefone que disparou esse evento.
ITPhoneEvent::get_RingMode

O método get_RingMode retorna um valor longo especificando o modo anel para o qual o telefone fez a transição. Essas informações só estão disponíveis quando o método ITPhoneEvent::get_Event retorna PE_RINGMODE.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)