Partilhar via


Referência de Serviços Básicos de Telefonia

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

Segue-se um agrupamento funcional das funções básicas do serviço de telefonia:

Inicialização e desligamento da TAPI

Função Descrição
lineInitializeEx Inicializa a abstração de linha TAPI para uso pelo aplicativo de invocação. Síncrono.
lineShutdown Desliga o uso do aplicativo da abstração de linha do TAPI. Síncrono.

 

Negociação de versão de linha

Função Descrição
lineNegotiateAPIVersion Permite que um aplicativo negocie uma versão TAPI para usar. Síncrono.

 

Status e recursos da linha

Função Descrição
lineGetDevCaps Retorna os recursos de um determinado dispositivo de linha. Síncrono.
lineGetDevConfig Retorna a configuração de um dispositivo de fluxo de mídia. Síncrono.
lineGetLineDevStatus Retorna o status atual do dispositivo de linha aberta especificado. Síncrono.
lineSetDevConfig Define a configuração do dispositivo de fluxo de mídia especificado. Síncrono.
lineSetStatusMessages Especifica as alterações de status para as quais o aplicativo precisa ser notificado. Síncrono.
lineGetStatusMessages Retorna as configurações atuais da mensagem de status de linha e endereço do aplicativo. Síncrono.
lineGetID Recupera um ID de dispositivo associado à linha, endereço ou chamada aberta especificado. Síncrono.
lineGetIcon Permite que um aplicativo recupere um ícone para exibição ao usuário. Síncrono.
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. Síncrono.
lineConfigDialogEdit Exibe uma caixa de diálogo que permite ao usuário alterar as informações de configuração de um dispositivo de linha. Síncrono.

 

Endereços

Função Descrição
lineGetAddressCaps Retorna os recursos de telefonia de um endereço. Síncrono.
lineGetAddressStatus Retorna o status atual de um endereço especificado. Síncrono.
lineGetAddressID Recupera o ID de endereço de um endereço especificado usando um formato alternativo. Síncrono.

 

Abrindo e fechando dispositivos de linha

Função Descrição
linhaAbrir Abre um dispositivo de linha especificado para fornecer monitoramento e/ou controle subsequente da linha. Síncrono.
lineFechar Fecha um dispositivo de linha aberta especificado. Síncrono.

 

Formatos de endereço

Função Descrição
linhaTranslateAddress Traduz entre um endereço em formato canônico e um endereço em formato discável. Síncrono.
lineSetCurrentLocation Define o local usado como contexto para a tradução de endereços. Síncrono.
lineSetTollList Manipula a lista de pedágios. Síncrono.
lineGetTranslateCaps Retorna recursos de conversão de endereços. Síncrono.

 

Estados e eventos de chamada

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

 

Fazer chamadas

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

 

Atender chamadas recebidas

Função Descrição
lineAnswer Atende a uma chamada recebida. Assíncrono.

 

Suporte Toll Saver

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

 

Controle de privilégio de chamada

Função Descrição
lineSetCallPrivilege Define o privilégio do aplicativo como o privilégio especificado. Síncrono.

 

Funções de queda de chamada

Função Descrição
lineDrop Desconecta uma chamada ou abandona uma tentativa de chamada em andamento. Assíncrono.
lineDeallocateCall Deslocaliza o identificador de chamada especificado. Síncrono.

 

Manipulação do identificador de chamadas

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

 

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

Função Descrição
lineTranslateDialog Exibe uma caixa de diálogo que permite ao usuário alterar a localização e as informações do cartão de chamada. Síncrono.
lineGetCountry Recupera regras de discagem e outras informações sobre um determinado país/região. Síncrono.

 

Solicitar Serviços de Destinatário

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

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