Referência básica dos Serviços de Telefonia

  • Artigo

As funções básicas de telefonia são listadas por categoria nas tabelas a seguir. Uma função será identificada como assíncrona se indicar a conclusão em uma mensagem REPLY para o aplicativo. Se a função sempre retornar seu resultado para o aplicativo imediatamente, a função será considerada síncrona.

Veja a seguir um agrupamento funcional das funções básicas do serviço de telefonia:

Inicialização e desligamento do TAPI

Função Descrição
Lineinitializeex Inicializa a abstração de linha TAPI para uso pelo aplicativo de invocação. Synchronous.
Lineshutdown Desliga o uso da abstração de linha do TAPI pelo aplicativo. Synchronous.

 

Negociação de versão de linha

Função Descrição
Linenegotiateapiversion Permite que um aplicativo negocie uma versão TAPI a ser usada. Synchronous.

 

Status e funcionalidades da linha

Função Descrição
Linegetdevcaps Retorna os recursos de um determinado dispositivo de linha. Synchronous.
Linegetdevconfig Retorna a configuração de um dispositivo de fluxo de mídia. Synchronous.
lineGetLineDevStatus Retorna o status atual do dispositivo de linha aberta especificado. Synchronous.
Linesetdevconfig Define a configuração do dispositivo de fluxo de mídia especificado. Synchronous.
lineSetStatusMessages Especifica o status alterações para as quais o aplicativo precisa ser notificado. Synchronous.
lineGetStatusMessages Retorna a linha e o endereço atuais do aplicativo status configurações de mensagem. Synchronous.
Linegetid Recupera uma ID de dispositivo associada à linha aberta, ao endereço ou à chamada especificada. Synchronous.
lineGetIcon Permite que um aplicativo recupere um ícone para exibição ao usuário. Synchronous.
lineConfigDialog Faz com que o provedor do dispositivo de linha especificado exiba uma caixa de diálogo que permite ao usuário configurar parâmetros relacionados ao dispositivo de linha. Synchronous.
Lineconfigdialogedit Exibe uma caixa de diálogo que permite que o usuário altere as informações de configuração de um dispositivo de linha. Synchronous.

 

Endereços

Função Descrição
Linegetaddresscaps Retorna os recursos de telefonia de um endereço. Synchronous.
Linegetaddressstatus Retorna o status atual de um endereço especificado. Synchronous.
lineGetAddressID Recupera a ID de endereço de um endereço especificado usando um formato alternativo. Synchronous.

 

Abrindo e fechando dispositivos de linha

Função Descrição
Lineopen Abre um dispositivo de linha especificado para fornecer monitoramento e/ou controle subsequentes da linha. Synchronous.
Lineclose Fecha um dispositivo de linha aberto especificado. Synchronous.

 

Formatos de endereço

Função Descrição
Linetranslateaddress Converte entre um endereço em formato canônico e um endereço no formato discável. Synchronous.
lineSetCurrentLocation Define o local usado como o contexto para tradução de endereço. Synchronous.
lineSetTollList Manipula a lista de pedágio. Synchronous.
Linegettranslatecaps Retorna os recursos de tradução de endereço. Synchronous.

 

Estados e eventos de chamada

Função Descrição
Linegetcallinfo Retorna informações fixas sobre uma chamada. Synchronous.
Linegetcallstatus Retorna informações de status de chamada completas para a chamada especificada. Synchronous.
lineSetAppSpecific Define o campo específico do aplicativo da estrutura de informações de uma chamada. Synchronous.

 

Fazendo chamadas

Função Descrição
Linemakecall Faz uma chamada de saída e retorna um identificador de chamada para ela. Assíncrono.
Linedial Disca (partes de um ou mais) endereços discáveis. Assíncrono.

 

Atendendo chamadas de entrada

Função Descrição
Lineanswer Atende a uma chamada de entrada. Assíncrono.

 

Suporte ao Toll Saver

Função Descrição
Linesetnumrings Indica o número de anéis após os quais as chamadas de entrada devem ser atendidas. Synchronous.
lineGetNumRings Retorna o número mínimo de anéis solicitados com lineSetNumRings. Synchronous.

 

Controle de privilégio de chamada

Função Descrição
lineSetCallPrivilege Define o privilégio do aplicativo como o privilégio especificado. Synchronous.

 

Funções de remoção de chamada

Função Descrição
Linedrop Desconecta uma chamada ou abandona uma tentativa de chamada em andamento. Assíncrono.
Linedeallocatecall Desaloca o identificador de chamada especificado. Synchronous.

 

Manipulação do identificador de chamada

Função Descrição
lineHandoff Entrega a propriedade da chamada e/ou altera os privilégios de um aplicativo para uma chamada. Synchronous.
lineGetNewCalls Retorna identificadores de chamada para chamadas em uma linha ou endereço especificado para o qual o aplicativo ainda não tem identificadores. Synchronous.
lineGetConfRelatedCalls Retorna uma lista de identificadores de chamada que fazem parte da mesma chamada em conferência que a chamada especificada como um parâmetro. Synchronous.

 

Informações de localização e país/região

Função Descrição
Linetranslatedialog Exibe uma caixa de diálogo que permite que o usuário altere o local e chame cartão informações. Synchronous.
lineGetCountry Recupera regras de discagem e outras informações sobre um determinado país/região. Synchronous.

 

Solicitar Serviços de Destinatário

As duas funções a seguir são usadas apenas no suporte à Telefonia Assistida.

Função Descrição
lineRegisterRequestRecipient Registra ou desregistra o aplicativo como um destinatário da solicitação para o modo de solicitação especificado. Synchronous.
lineGetRequest Obtém a próxima solicitação da biblioteca de vínculo dinâmico de telefonia. Synchronous.