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

As funções básicas de telefonia 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 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 de serviço de telefonia:

• formatos de endereço
• endereços
• atendendo chamadas de entrada
• de funções de descarte de chamadas
• manipulação de identificador de chamada
• de controle de privilégio de chamada
• de Eventos e Estados de Chamada
• status e recursos de linha
• de negociação de versão de linha de
• de Informações de Local e País/Região
• fazendo chamadas
• dispositivos de linha de abertura e fechamento
• solicitar serviços de destinatário
• inicialização e desligamento do TAPI
• de suporte do Toll Saver

Inicialização e desligamento do TAPI

Função	Descrição
lineInitializeEx	Inicializa a abstração de linha TAPI para uso pelo aplicativo invocando. 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 a ser usada. Síncrono.

 

Status e funcionalidades de 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 de mensagem de status de linha e endereço do aplicativo. Síncrono.
lineGetID	Recupera uma ID do dispositivo associada à linha aberta, ao endereço ou à chamada especificados. 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 permitindo que o usuário altere 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 a 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
lineOpen	Abre um dispositivo de linha especificado para fornecer o monitoramento subsequente e/ou o controle da linha. Síncrono.
lineClose	Fecha um dispositivo de linha aberta especificado. Síncrono.

 

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. Síncrono.
lineSetCurrentLocation	Define o local usado como o contexto para tradução de endereço. Síncrono.
lineSetTollList	Manipula a lista de pedágio. Síncrono.
lineGetTranslateCaps	Retorna recursos de tradução de endereço. 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 de status de chamada completas para a chamada especificada. Síncrono.
lineSetAppSpecific	Define o campo específico do aplicativo da estrutura de informações de uma chamada. Síncrono.

 

Fazendo chamadas

Função	Descrição
lineMakeCall	Faz uma chamada de saída e retorna um identificador de chamada para ela. Assíncrono.
lineDial	Discagem (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. 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 descarte de chamadas

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. Síncrono.

 

Manipulação do identificador de chamada

Função	Descrição
lineHandoff	Entrega a propriedade de 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 de local e país/região

Função	Descrição
lineTranslateDialog	Exibe uma caixa de diálogo permitindo que o usuário altere as informações de local e cartão de visita. 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 no suporte à Telefonia Assistida.

Função	Descrição
lineRegisterRequestRecipient	Registra ou desregistros 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 link dinâmico de telefonia. Síncrono.