cabeçalho tspi.h

Esse cabeçalho é usado por várias tecnologias. Para obter mais informações, consulte:

• TAPI 2.2
• Provedor de Serviços de Telefonia

tspi.h contém as seguintes interfaces de programação:

Funções

TSPI_lineAccept A função TSPI_lineAccept aceita a chamada oferecida especificada. Opcionalmente, ele pode enviar as informações de usuário-usuário especificadas para a parte de chamada.
TSPI_lineAddToConference A função TSPI_lineAddToConference adiciona a chamada especificada por hdConsultCall à chamada de conferência especificada por hdConfCall.
TSPI_lineAnswer A função TSPI_lineAnswer atende à chamada de oferta especificada.
TSPI_lineBlindTransfer A função TSPI_lineBlindTransfer executa uma transferência cega ou em etapa única da chamada especificada para o endereço de destino especificado.
TSPI_lineClose A função TSPI_lineClose fecha o dispositivo de linha aberta especificado depois de concluir ou anular todas as chamadas pendentes e operações assíncronas no dispositivo.
TSPI_lineCloseCall A função TSPI_lineCloseCall desaloca a chamada depois de concluir ou anular todas as operações assíncronas pendentes na chamada.
TSPI_lineCloseMSPInstance A função TSPI_lineCloseMSPInstance direciona a DLL tapi 3 para fechar uma instância de chamada msp (provedor de serviços de mídia). Essa função requer a negociação de versão do TAPI 3.0.
TSPI_lineCompleteCall A função TSPI_lineCompleteCall é usada para especificar como uma chamada que não pode ser conectada normalmente deve ser concluída.
TSPI_lineCompleteTransfer A função TSPI_lineCompleteTransfer conclui a transferência da chamada especificada para a parte conectada na chamada de consulta.
TSPI_lineConditionalMediaDetection A função TSPI_lineConditionalMediaDetection é invocada pelo TAPI sempre que um aplicativo cliente usa LINEMAPPER como dwDeviceID em uma chamada de função lineOpen.
TSPI_lineConfigDialog A função TSPI_lineConfigDialog está obsoleta. O TAPI versão 1.4 ou provedores de serviços anteriores podem implementar essa função TSPI. TSPs tapi versão 2.0 ou posterior implementam TUISPI_lineConfigDialog.
TSPI_lineConfigDialogEdit A função TSPI_lineConfigDialogEdit está obsoleta. O TAPI versão 1.4 ou provedores de serviços anteriores podem implementar essa função TSPI. TSPs tapi versão 2.0 ou posterior implementam TUISPI_lineConfigDialogEdit.
TSPI_lineCreateMSPInstance A função TSPI_lineCreateMSPInstance direciona a DLL do TAPI 3 para criar uma instância do MSP (provedor de serviços de mídia) para um dispositivo de linha específico. Essa função retorna um identificador TSP para a chamada MSP. Essa função requer a negociação de versão do TAPI 3.0.
TSPI_lineDevSpecific A função TSPI_lineDevSpecific é usada como um mecanismo de extensão geral para permitir que os provedores de serviços forneçam acesso a recursos não descritos em outras operações.
TSPI_lineDevSpecificFeature A função TSPI_lineDevSpecificFeature é usada como um mecanismo de extensão para permitir que os provedores de serviços forneçam acesso a recursos não descritos em outras operações.
Tspi_linedial A função TSPI_lineDial disca o número discável especificado na chamada especificada.
Tspi_linedrop A função TSPI_lineDrop remove ou desconecta a chamada especificada.
TSPI_lineForward A função TSPI_lineForward encaminha chamadas destinadas ao endereço especificado na linha especificada, de acordo com as instruções de encaminhamento especificadas.
TSPI_lineGatherDigits A função TSPI_lineGatherDigits inicia a coleta em buffer de dígitos na chamada especificada. TAPI especifica um buffer no qual colocar os dígitos e o número máximo de dígitos a serem coletados.
Tspi_linegeneratedigits A função TSPI_lineGenerateDigits inicia a geração dos dígitos especificados na chamada especificada como tons em banda usando o modo de sinalização especificado.
Tspi_linegeneratetone A função TSPI_lineGenerateTone gera a inband de tom especificada sobre a chamada especificada.
TSPI_lineGetAddressCaps A função TSPI_lineGetAddressCaps consulta o endereço especificado no dispositivo de linha especificado para determinar seus recursos de telefonia.
TSPI_lineGetAddressID A função TSPI_lineGetAddressID retorna o identificador de endereço associado ao endereço em um formato diferente na linha especificada.
TSPI_lineGetAddressStatus A função TSPI_lineGetAddressStatus consulta o endereço especificado para seu status atual.
TSPI_lineGetCallAddressID A função TSPI_lineGetCallAddressID recupera o identificador de endereço para a chamada indicada.
TSPI_lineGetCallHubTracking A função TSPI_lineGetCallHubTracking retorna o estado atual do acompanhamento do CallHub para o provedor de serviços. Essa função requer a negociação de versão do TAPI 3.0.
TSPI_lineGetCallIDs A função TSPI_lineGetCallIDs retorna os identificadores de chamada para o provedor de serviços. Essa função requer a negociação de versão do TAPI 3.0.
TSPI_lineGetCallInfo A função TSPI_lineGetCallInfo retorna informações detalhadas sobre a chamada especificada.
TSPI_lineGetCallStatus A função TSPI_lineGetCallStatus retorna o status atual da chamada especificada.
TSPI_lineGetDevCaps A função TSPI_lineGetDevCaps consulta um dispositivo de linha especificado para determinar seus recursos de telefonia. As informações retornadas são válidas para todos os endereços no dispositivo de linha.
Tspi_linegetdevconfig A função TSPI_lineGetDevConfig retorna um objeto de estrutura de dados, cujo conteúdo é específico da linha (provedor de serviços) e da classe de dispositivo, dando a configuração atual de um dispositivo associado um para um com o dispositivo de linha.
TSPI_lineGetExtensionID A função TSPI_lineGetExtensionID retorna o identificador de extensão compatível com o provedor de serviços para o dispositivo de linha indicado.
TSPI_lineGetIcon A função TSPI_lineGetIcon recupera um ícone específico do dispositivo da linha de serviço a ser exibido para o usuário.
Tspi_linegetid A função TSPI_lineGetID retorna um identificador de dispositivo para a classe de dispositivo especificada associada à linha, endereço ou chamada selecionada.
TSPI_lineGetLineDevStatus A função TSPI_lineGetLineDevStatus consulta o dispositivo de linha aberta especificado para seu status atual. As informações retornadas são globais para todos os endereços na linha.
TSPI_lineGetNumAddressIDs A função TSPI_lineGetNumAddressIDs recupera o número de identificadores de endereço com suporte na linha indicada.
TSPI_lineHold A função TSPI_lineHold coloca a chamada especificada em espera.
Tspi_linemakecall A função TSPI_lineMakeCall coloca uma chamada na linha especificada para o endereço de destino especificado. Opcionalmente, os parâmetros de chamada poderão ser especificados se qualquer coisa, exceto os parâmetros de configuração de chamada padrão, forem solicitados.
TSPI_lineMonitorDigits A função TSPI_lineMonitorDigits habilita e desabilita a detecção sem erros de dígitos recebidos na chamada.
TSPI_lineMonitorMedia A função TSPI_lineMonitorMedia habilita e desabilita a detecção de tipos de mídia na chamada especificada. Quando um tipo de mídia é detectado, uma mensagem LINE_MONITORMEDIA é enviada ao TAPI.
TSPI_lineMonitorTones A função TSPI_lineMonitorTones habilita e desabilita a detecção de tons de banda na chamada. Sempre que um tom especificado é detectado, uma mensagem é enviada ao aplicativo cliente por meio do TAPI.
TSPI_lineMSPIdentify A função TSPI_lineMSPIdentify determina o CLSID do MSP associado para cada linha. Essa função requer a negociação de versão do TAPI 3.0.
TSPI_lineNegotiateExtVersion A função TSPI_lineNegotiateExtVersion retorna o número de versão de extensão mais alto em que o provedor de serviços pode operar para esse dispositivo, considerando o intervalo de versões de extensão possíveis.
Tspi_linenegotiatetspiversion A função TSPI_lineNegotiateTSPIVersion retorna a versão mais alta do SPI em que o provedor de serviços pode operar para esse dispositivo, considerando o intervalo de versões de SPI possíveis.
TSPI_lineOpen A função TSPI_lineOpen abre o dispositivo de linha cujo identificador de dispositivo é dado, retornando o identificador do provedor de serviços para o dispositivo.
TSPI_linePark A função TSPI_linePark estaciona a chamada especificada de acordo com o modo de parque especificado.
TSPI_linePickup A função TSPI_linePickup capta um alerta de chamada no endereço de destino especificado e retorna um identificador de chamada para a chamada escolhida.
TSPI_linePrepareAddToConference A função TSPI_linePrepareAddToConference prepara uma chamada de conferência existente para a adição de outra parte. Ele cria uma nova chamada de consulta temporária. A nova chamada de consulta pode ser adicionada posteriormente à chamada em conferência.
TSPI_lineReceiveMSPData O provedor de serviços de funções TSPI_lineReceiveMSPData recebe dados enviados pelo MSP (provedor de serviços de mídia). Essa função requer a negociação de versão do TAPI 3.0.
TSPI_lineRedirect A função TSPI_lineRedirect redireciona a chamada de oferta especificada para o endereço de destino especificado.
TSPI_lineReleaseUserUserInfo A função TSPI_lineReleaseUserUserInfo informa ao provedor de serviços que as informações de usuário contidas na estrutura LINECALLINFO foram processadas e que, posteriormente, as informações de usuário-usuário recebidas agora podem ser gravadas nessa estrutura.
TSPI_lineRemoveFromConference A função TSPI_lineRemoveFromConference remove a chamada especificada da chamada de conferência à qual pertence atualmente. As chamadas restantes na teleconferência não são afetadas.
TSPI_lineSecureCall A função TSPI_lineSecureCall protege a chamada de quaisquer interrupções ou interferências que possam afetar o fluxo de mídia da chamada.
TSPI_lineSelectExtVersion A função TSPI_lineSelectExtVersion seleciona a versão de extensão indicada para o dispositivo de linha indicado. As solicitações subsequentes operam de acordo com essa versão de extensão.
TSPI_lineSendUserUserInfo A função TSPI_lineSendUserUserInfo envia informações de usuário-usuário para a parte remota na chamada especificada.
TSPI_lineSetAppSpecific A função TSPI_lineSetAppSpecific define o campo específico do aplicativo da estrutura LINECALLINFO da chamada especificada.
TSPI_lineSetCallData O TSPI_lineSetCallData provedor de serviços de funções armazena os dados de chamada indicados com suas informações relacionadas à chamada e, posteriormente, os entrega sempre que TSPI_lineGetCallInfo é chamado.
TSPI_lineSetCallHubTracking A função TSPI_lineSetCallHubTracking define o modo de acompanhamento do CallHub. Essa função requer a negociação de versão do TAPI 3.0.
TSPI_lineSetCallParams A função TSPI_lineSetCallParams define determinados parâmetros para uma chamada existente.
TSPI_lineSetCallQualityOfService O provedor de serviços de funções TSPI_lineSetCallQualityOfService tenta renegociar o QOS na chamada com a opção Se o QOS desejado não estiver disponível, a função falhará, mas a chamada continuará com o QOS anterior.
TSPI_lineSetCallTreatment O provedor de serviços de funções TSPI_lineSetCallTreatment armazena o dwCallTreatment indicado em LINECALLINFO e envia uma mensagem LINE_CALLINFO para indicar as informações atualizadas.
TSPI_lineSetDefaultMediaDetection O procedimento TSPI_lineSetDefaultMediaDetection informa ao provedor de serviços o novo conjunto de tipos de mídia a ser detectado para a linha indicada (substituindo qualquer conjunto anterior).
TSPI_lineSetDevConfig A função TSPI_lineSetDevConfig restaura a configuração de um dispositivo associado um para um com o dispositivo de linha de uma estrutura de dados obtida anteriormente usando TSPI_lineGetDevConfig.
TSPI_lineSetLineDevStatus O provedor de serviços TSPI_lineSetLineDevStatus define o dispositivo status conforme indicado, enviando mensagens de LINE_LINEDEVSTATE apropriadas para indicar o novo status.
TSPI_lineSetMediaControl A função TSPI_lineSetMediaControl habilita e desabilita as ações de controle no fluxo de mídia associado à linha, ao endereço ou à chamada especificados.
TSPI_lineSetMediaMode A função TSPI_lineSetMediaMode altera a mídia da chamada conforme armazenada na estrutura LINECALLINFO da chamada.
TSPI_lineSetStatusMessages A função TSPI_lineSetStatusMessages permite que TAPI especifique quais mensagens de notificação o provedor de serviços deve gerar para eventos relacionados a status alterações para a linha especificada ou qualquer um de seus endereços.
TSPI_lineSetTerminal A função TSPI_lineSetTerminal permite que TAPI especifique para quais informações de terminal relacionadas à linha, endereço ou chamada especificadas devem ser roteadas.
TSPI_lineSetupConference A função TSPI_lineSetupConference configura uma chamada em conferência para a adição de terceiros.
TSPI_lineSetupTransfer A função TSPI_lineSetupTransfer inicia uma transferência da chamada especificada por hdCall. Ele estabelece uma chamada de consulta, lphdConsultCall, na qual a parte pode ser discada que pode se tornar o destino da transferência.
TSPI_lineSwapHold A função TSPI_lineSwapHold troca a chamada ativa especificada pela chamada especificada em espera de consulta.
TSPI_lineUncompleteCall A função TSPI_lineUncompleteCall é usada para cancelar a solicitação de conclusão de chamada especificada na linha especificada.
TSPI_lineUnhold A função TSPI_lineUnhold recupera a chamada mantida especificada.
TSPI_lineUnpark A função TSPI_lineUnpark recupera a chamada estacionada no endereço especificado e retorna um identificador de chamada para ela.
TSPI_phoneClose A função TSPI_phoneClose fecha o dispositivo de telefone aberto especificado depois de concluir ou anular todas as operações assíncronas pendentes no dispositivo.
TSPI_phoneConfigDialog A função TSPI_phoneConfigDialog está obsoleta. O TAPI versão 1.4 ou provedores de serviços anteriores podem implementar essa função TSPI. TSPs tapi versão 2.0 ou posterior implementam TUISPI_phoneConfigDialog.
TSPI_phoneDevSpecific A função TSPI_phoneDevSpecific é usada como um mecanismo de extensão geral para habilitar uma implementação de API de Telefonia para fornecer recursos não descritos nas outras operações. Os significados dessas extensões são específicos do dispositivo.
TSPI_phoneGetButtonInfo A função TSPI_phoneGetButtonInfo retorna informações sobre um botão especificado.
TSPI_phoneGetData A função TSPI_phoneGetData carrega as informações do local especificado no dispositivo de telefone aberto para o buffer especificado.
TSPI_phoneGetDevCaps A função TSPI_phoneGetDevCaps consulta um dispositivo de telefone especificado para determinar seus recursos de telefonia.
TSPI_phoneGetDisplay A função TSPI_phoneGetDisplay retorna o conteúdo atual da exibição de telefone especificada.
TSPI_phoneGetExtensionID A função TSPI_phoneGetExtensionID recupera o identificador de extensão compatível com o provedor de serviços para o dispositivo de telefone indicado.
TSPI_phoneGetGain A função TSPI_phoneGetGain retorna a configuração de ganho do microfone do dispositivo hookswitch do telefone especificado.
TSPI_phoneGetHookSwitch A função TSPI_phoneGetHookSwitch retorna o modo hookswitch atual do dispositivo de telefone aberto especificado.
TSPI_phoneGetIcon A função TSPI_phoneGetIcon recupera um ícone específico do dispositivo do telefone de serviço (ou específico do provedor) a ser exibido para o usuário.
TSPI_phoneGetID A função TSPI_phoneGetID retorna um identificador de dispositivo para a classe de dispositivo especificada associada ao dispositivo de telefone especificado.
TSPI_phoneGetLamp A função TSPI_phoneGetLamp retorna o modo de lâmpada atual da lâmpada especificada.
TSPI_phoneGetRing A função TSPI_phoneGetRing permite que um aplicativo consulte o dispositivo de telefone aberto especificado quanto ao modo de anel atual.
TSPI_phoneGetStatus A função TSPI_phoneGetStatus consulta o dispositivo de telefone aberto especificado para seu status geral.
TSPI_phoneGetVolume A função TSPI_phoneGetVolume retorna a configuração de volume do dispositivo hookswitch do telefone especificado.
TSPI_phoneNegotiateExtVersion A função TSPI_phoneNegotiateExtVersion retorna o número de versão de extensão mais alto em que o provedor de serviços pode operar para esse dispositivo, considerando o intervalo de versões de extensão possíveis.
Tspi_phonenegotiatetspiversion A função TSPI_phoneNegotiateTSPIVersion retorna a versão mais alta do SPI na qual o provedor de serviços pode operar para esse dispositivo, considerando o intervalo de versões de SPI possíveis.
TSPI_phoneOpen A função TSPI_phoneOpen abre o dispositivo de telefone cujo identificador de dispositivo é dado, retornando o identificador opaco do provedor de serviços para o dispositivo e retendo o identificador opaco da TAPI para o dispositivo para uso em chamadas subsequentes para o procedimento PHONEEVENT.
TSPI_phoneSelectExtVersion A função TSPI_phoneSelectExtVersion seleciona a versão de extensão indicada para o dispositivo de telefone indicado. As solicitações subsequentes operam de acordo com essa versão de extensão.
TSPI_phoneSetButtonInfo A função TSPI_phoneSetButtonInfo define informações sobre o botão especificado no telefone especificado.
TSPI_phoneSetData A função TSPI_phoneSetData baixa as informações no buffer especificado para o dispositivo de telefone aberto no identificador de dados selecionado.
TSPI_phoneSetDisplay A função TSPI_phoneSetDisplay faz com que a cadeia de caracteres especificada seja exibida no dispositivo de telefone aberto especificado.
TSPI_phoneSetGain A função TSPI_phoneSetGain define o ganho do microfone do dispositivo hookswitch especificado para o nível de ganho especificado.
TSPI_phoneSetHookSwitch A função TSPI_phoneSetHookSwitch define o estado do gancho dos dispositivos hookswitch do telefone aberto especificados para o modo especificado. Somente o estado hookswitch dos dispositivos hookswitch listados é afetado.
TSPI_phoneSetLamp A função TSPI_phoneSetLamp faz com que a lâmpada especificada seja definida no dispositivo de telefone aberto especificado no modo de lâmpada especificado.
TSPI_phoneSetRing A função TSPI_phoneSetRing toca o dispositivo de telefone aberto especificado usando o modo de anel e o volume especificados.
TSPI_phoneSetStatusMessages A função TSPI_phoneSetStatusMessages faz com que o provedor de serviços filtre status mensagens que atualmente não são de interesse de nenhum aplicativo.
TSPI_phoneSetVolume A função TSPI_phoneSetVolume define o volume do componente do alto-falante do dispositivo hookswitch especificado para o nível especificado.
TSPI_providerConfig A função TSPI_providerConfig está obsoleta. O TAPI versão 1.4 ou provedores de serviços anteriores podem implementar essa função TSPI. TSPs tapi versão 2.0 ou posterior implementam TUISPI_providerConfig.
TSPI_providerCreateLineDevice A função TSPI_providerCreateLineDevice é chamada pelo TAPI em resposta ao recebimento de uma mensagem LINE_CREATE do provedor de serviços, o que permite a criação dinâmica de um novo dispositivo de linha.
TSPI_providerCreatePhoneDevice A função TSPI_providerCreatePhoneDevice é chamada pelo TAPI em resposta ao recebimento de uma mensagem PHONE_CREATE do provedor de serviços, o que permite a criação dinâmica de um novo dispositivo de telefone.
Tspi_providerenumdevices O TAPI chama a função TSPI_providerEnumDevices antes de TSPI_providerInit para determinar o número de dispositivos de linha e telefone compatíveis com o provedor de serviços.
TSPI_providerFreeDialogInstance A função TSPI_providerFreeDialogInstance informa ao provedor de serviços que a caixa de diálogo associada ao hdDlgInst foi encerrada.
TSPI_providerGenericDialogData A função TSPI_providerGenericDialogData fornece aos dados do provedor de serviços que foram enviados da DLL da interface do usuário em execução em um contexto de aplicativo por meio da função TUISPIDLLCALLBACK.
Tspi_providerinit A função TSPI_providerInit inicializa o provedor de serviços e fornece parâmetros necessários para operações subsequentes.
TSPI_providerInstall A função TSPI_providerInstall está obsoleta. O TAPI versão 1.4 ou provedores de serviços anteriores podem implementar essa função TSPI. TSPs tapi versão 2.0 ou posterior implementam TUISPI_providerInstall.
TSPI_providerRemove A função TSPI_providerRemove está obsoleta. O TAPI versão 1.4 ou provedores de serviços anteriores podem implementar essa função TSPI. TSPs tapi versão 2.0 ou posterior implementam TUISPI_providerRemove.
TSPI_providerShutdown A função TSPI_providerShutdown desliga o provedor de serviços. O provedor de serviços encerra todas as atividades que tem em andamento e libera todos os recursos alocados.
TSPI_providerUIIdentify A função TSPI_providerUIIdentify extrai do provedor de serviços o caminho totalmente qualificado para carregar o componente DLL da interface do usuário do provedor de serviços.
TUISPI_lineConfigDialog A função TUISPI_lineConfigDialog faz com que o provedor do dispositivo de linha especificado exiba uma caixa de diálogo modal como uma janela filho do hwndOwner para permitir que o usuário configure parâmetros relacionados ao dispositivo de linha.
TUISPI_lineConfigDialogEdit A função TUISPI_lineConfigDialogEdit faz com que o provedor do dispositivo de linha especificado exiba uma caixa de diálogo modal como uma janela filho de hwndOwner para permitir que o usuário configure parâmetros relacionados ao dispositivo de linha.
TUISPI_phoneConfigDialog A função TUISPI_phoneConfigDialog faz com que o provedor do dispositivo de telefone especificado exiba uma caixa de diálogo modal como uma janela filho de hwndOwner para permitir que o usuário configure parâmetros relacionados ao dispositivo de telefone.
TUISPI_providerConfig A função TUISPI_providerConfig implementa os elementos de interface do usuário que devem ser executados no contexto do aplicativo de chamada. Essa função torna a função TSPI_providerConfig obsoleta na versão 2.0 e posterior (com suporte na versão 1.4 e anterior).
TUISPI_providerGenericDialog A função TUISPI_providerGenericDialog na DLL da interface do usuário é chamada quando o provedor de serviços envia uma mensagem LINE_CREATEDIALOGINSTANCE.
TUISPI_providerGenericDialogData A função TUISPI_providerGenericDialogData na DLL da interface do usuário é chamada quando o provedor de serviços envia uma mensagem LINE_SENDDIALOGINSTANCEDATA.
TUISPI_providerInstall A implementação da função TUISPI_providerInstall é a oportunidade do provedor de serviços de instalar quaisquer "partes" adicionais do provedor nos diretórios corretos e configurar entradas de registro de que o provedor precisa.
TUISPI_providerRemove A função TUISPI_providerRemove solicita que o usuário confirme a eliminação do provedor de serviços. Essa função torna a função TSPI_providerRemove obsoleta na versão 2.0 e posterior (com suporte na versão 1.4 e anterior).

Funções de retorno de chamada

ASYNC_COMPLETION Completion_Proc é uma função de retorno de chamada implementada pelo TAPI e fornecida ao provedor de serviços como um parâmetro para TSPI_providerInit.
LINEEVENT Line_Event é uma função de retorno de chamada implementada pelo TAPI e fornecida ao provedor de serviços como um parâmetro para TSPI_lineOpen. O provedor de serviços chama essa função para relatar eventos que ocorrem na linha ou em chamadas na linha.
PHONEEVENT Phone_Event uma função de retorno de chamada implementada pelo TAPI e fornecida ao provedor de serviços como um parâmetro para TSPI_phoneOpen. O provedor de serviços chama essa função para relatar eventos que ocorrem no telefone.
TUISPIDLLCALLBACK A função DllCallbackProc é chamada pela DLL da interface do usuário para enviar um bloco de parâmetro privado para o provedor de serviços.

Estruturas

TUISPICREATEDIALOGINSTANCEPARAMS A estrutura de dados TUISPI é definida abaixo.