Compartilhar via


Interface ITAutomatedPhoneControl (tapi3if.h)

O ITAutomatedPhoneControl é uma interface totalmente automatizada e com script OLE exposta pelo objeto de telefone TAPI. Quando um dispositivo de telefone é aberto com privilégio de proprietário, você pode chamar o método QueryInterface na interface ITPhone para obter um ponteiro de interface ITAutomatedPhoneControl .

Essa interface executa várias funções relacionadas ao telefone de alto nível:

  • Habilite e configure o controle automatizado dos tons e anéis do telefone com base na entrada dos botões hookswitch e do telefone.
  • Habilite e configure o tratamento automatizado de chamadas com base no estado hookswitch do telefone. Por exemplo, quando o telefone fica ativado enquanto está tratando uma chamada conectada, o objeto de telefone pode invocar automaticamente ITBasicCallControl::D isconnect nessa chamada.
  • Gere tons específicos nos dispositivos de áudio associados ao telefone, sem acessar nenhuma APIs de áudio diretamente. O controle de tom permite que um aplicativo reproduza tons nos dispositivos de áudio associados ao telefone, fora do contexto de uma chamada. Como esses tons não são transmitidos em nenhuma chamada, eles são independentes da funcionalidade de streaming de áudio acessada por meio de terminais.
  • Toque no telefone sem exigir informações sobre se o telefone tem um toque e, se o telefone tiver um toque, determine os tipos de toques compatíveis com o telefone.

Herança

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

Métodos

A interface ITAutomatedPhoneControl tem esses métodos.

 
ITAutomatedPhoneControl::EnumerateSelectedCalls

O método EnumerateSelectedCalls recupera um objeto enumerador que indica quais chamadas estão selecionadas no momento neste telefone. Consulte ITAutomatedPhoneControl::SelectCall para obter mais informações.
ITAutomatedPhoneControl::get_AutoDialtone

O método get_AutoDialtone recupera o valor atual da propriedade AutoDialtone.
ITAutomatedPhoneControl::get_AutoEndOfNumberTimeout

O método get_AutoEndOfNumberTimeout recupera o valor atual da propriedade AutoEndOfNumberTimeout. A propriedade especifica quanto tempo aguardar depois que um dígito tiver sido pressionado antes que se presuma que todo o número foi coletado.
ITAutomatedPhoneControl::get_AutoKeypadTones

O método get_AutoKeypadTones obtém a propriedade AutoKeypadTones para este telefone. Quando esse recurso está habilitado, um tom de dígito é reproduzido automaticamente sempre que um botão do teclado é pressionado.
ITAutomatedPhoneControl::get_AutoKeypadTonesMinimumDuration

O método get_AutoKeypadTonesMinimumDuration recupera o valor atual da propriedade AutoKeypadTonesMinimumDuration. A propriedade especifica por quanto tempo reproduzir tons de teclado em PBS_DOWN.
ITAutomatedPhoneControl::get_AutoStopRingOnOffHook

O método get_AutoStopRingOnOffHook recupera o valor atual da propriedade AutoStopRingOnOffHook.
ITAutomatedPhoneControl::get_AutoStopTonesOnOnHook

O método get_AutoStopTonesOnOnHook recupera o valor atual da propriedade AutoStopTonesOnOnHook.
ITAutomatedPhoneControl::get_AutoVolumeControl

O método get_AutoVolumeControl recupera o valor atual da propriedade AutoVolumeControl.
ITAutomatedPhoneControl::get_AutoVolumeControlRepeatDelay

O método get_AutoVolumeControlRepeatDelay recupera o valor atual da propriedade AutoVolumeControlRepeatDelay. A propriedade especifica o atraso, em milissegundos (ms), antes que um botão de volume comece a se repetir quando for mantido pressionado.
ITAutomatedPhoneControl::get_AutoVolumeControlRepeatPeriod

O método get_AutoVolumeControlRepeatPeriod recupera o valor atual da propriedade AutoVolumeControlRepeatPeriod. A propriedade controla o período, em milissegundos (ms), de repetições de botão quando um botão de volume é mantido pressionado.
ITAutomatedPhoneControl::get_AutoVolumeControlStep

O método get_AutoVolumeControlStep recupera o valor atual da propriedade AutoVolumeControlStep. A propriedade determina a quantidade que o volume do telefone é ajustado quando o botão de volume é pressionado.
ITAutomatedPhoneControl::get_PhoneHandlingEnabled

O método get_PhoneHandlingEnabled recupera o valor atual da propriedade PhoneHandlingEnabled.
ITAutomatedPhoneControl::get_Ringer

O método get_Ringer retorna um valor booliano que indica se o telefone está executando um anel de entrada que foi iniciado pelo método StartRinger nessa interface.
ITAutomatedPhoneControl::get_SelectedCalls

O método get_SelectedCalls recupera um VARIANT que contém um ponteiro para um objeto de coleção que indica quais chamadas estão selecionadas no momento neste telefone. Consulte ITAutomatedPhoneControl::SelectCall para obter mais informações.
ITAutomatedPhoneControl::get_Tone

O método get_Tone retorna um valor de enumeração PHONE_TONE indicando o tipo de tom, se houver, que o telefone está sendo reproduzido no momento.
ITAutomatedPhoneControl::p ut_AutoDialtone

O método put_AutoDialtone define o valor da propriedade AutoDialtone.
ITAutomatedPhoneControl::p ut_AutoEndOfNumberTimeout

O método put_AutoEndOfNumberTimeout define o valor da propriedade AutoEndOfNumberTimeout. A propriedade especifica quanto tempo aguardar depois que um dígito tiver sido pressionado antes que se presuma que todo o número foi coletado.
ITAutomatedPhoneControl::p ut_AutoKeypadTones

O método put_AutoKeypadTones define a propriedade AutoKeypadTones para este telefone. Quando esse recurso está habilitado, um tom de dígito é reproduzido automaticamente sempre que um botão do teclado é pressionado.
ITAutomatedPhoneControl::p ut_AutoKeypadTonesMinimumDuration

O método put_AutoKeypadTonesMinimumDuration define o valor da propriedade AutoKeypadTonesMinimumDuration. A propriedade especifica por quanto tempo reproduzir tons de teclado em PBS_DOWN.
ITAutomatedPhoneControl::p ut_AutoStopRingOnOffHook

O método put_AutoStopRingOnOffHook define a propriedade AutoStopRingOnOffHook. Quando esse recurso está habilitado, o telefone desligado resulta no encerramento de qualquer anel de entrada produzido no telefone (por meio de uma chamada para ITAutomatedPhoneControl::StopRinger).
ITAutomatedPhoneControl::p ut_AutoStopTonesOnOnHook

O método put_AutoStopTonesOnOnHook define a propriedade AutoStopTonesOnOnHook para este telefone.
ITAutomatedPhoneControl::p ut_AutoVolumeControl

O método put_AutoVolumeControl define a propriedade AutoVolumeControl para este telefone.
ITAutomatedPhoneControl::p ut_AutoVolumeControlRepeatDelay

O método put_AutoVolumeControlRepeatDelay define a propriedade AutoVolumeControlRepeatDelay. A propriedade especifica o atraso, em milissegundos (ms), antes que um botão de volume comece a se repetir quando for mantido pressionado.
ITAutomatedPhoneControl::p ut_AutoVolumeControlRepeatPeriod

O método put_AutoVolumeControlRepeatPeriod define a propriedade AutoVolumeControlRepeatPeriod. A propriedade controla o período, em milissegundos (ms), de repetições de botão quando um botão de volume é mantido pressionado.
ITAutomatedPhoneControl::p ut_AutoVolumeControlStep

O método put_AutoVolumeControlStep define a propriedade AutoVolumeControlStep. A propriedade determina a quantidade que o volume do telefone é ajustado quando o botão de volume é pressionado.
ITAutomatedPhoneControl::p ut_PhoneHandlingEnabled

O método put_PhoneHandlingEnabled define a propriedade PhoneHandlingEnabled.
ITAutomatedPhoneControl::SelectCall

O método SelectCall seleciona o objeto de telefone atual no objeto Call apontado pelo parâmetro pCall.
ITAutomatedPhoneControl::StartRinger

O método StartRinger inicia o toque do telefone, especificando o modo anel e a duração do anel.
ITAutomatedPhoneControl::StartTone

O método StartTone envia tons de controle.
ITAutomatedPhoneControl::StopRinger

O método StopRinger interrompe qualquer anel de entrada que está sendo produzido no momento. Se nenhum anel estiver sendo produzido, o método não executará nenhuma ação e retornará êxito.
ITAutomatedPhoneControl::StopTone

O método StopTone interrompe qualquer tom que esteja sendo reproduzido no momento. Se nenhum tom estiver sendo reproduzido, o método não executará nenhuma ação e retornará êxito.
ITAutomatedPhoneControl::UnselectCall

O método UnselectCall remove a chamada especificada desse objeto de telefone, liberando a referência do objeto de telefone ao objeto de chamada.

Comentários

Um ponteiro ITAutomatedPhoneControl torna-se inválido quando o método ITPhone::Close é chamado.

Requisitos

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

Confira também

IDispatch

ITPhone