função TSPI_lineOpen (tspi.h)

Artigo
03/13/2024

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. O provedor de serviços deve manter o identificador TAPI para o dispositivo para uso em chamadas subsequentes para o procedimento de retorno de chamada LINEEVENT .

Sintaxe

LONG TSPIAPI TSPI_lineOpen(
  DWORD      dwDeviceID,
  HTAPILINE  htLine,
  LPHDRVLINE lphdLine,
  DWORD      dwTSPIVersion,
  LINEEVENT  lpfnEventProc
);

Parâmetros

dwDeviceID

Identifica o dispositivo de linha a ser aberto.

htLine

O identificador TAPI para o dispositivo de linha a ser usado em chamadas subsequentes para o procedimento de retorno de chamada LINEEVENT para identificar o dispositivo.

lphdLine

Um ponteiro para um HDRVLINE em que o provedor de serviços preenche seu identificador para o dispositivo de linha.

dwTSPIVersion

A versão do TSPI.

lpfnEventProc

Um ponteiro para o procedimento de retorno de chamada LINEEVENT fornecido pelo TAPI que o provedor de serviços chama para relatar eventos subsequentes na linha.

Retornar valor

Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:

LINEERR_ALLOCATED, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Comentários

O provedor de serviços deve reservar todos os recursos não fragmentáveis necessários para gerenciar a linha. No entanto, todas as ações que podem ser adiadas para lineMakeCall devem ser. É uma suposição de design no TAPI que lineOpen é uma operação "barata". Por exemplo, se a linha for aberta apenas no modo de monitor, não será necessário que um provedor de serviços baseado em porta COMM abra a porta COMM.

Este procedimento não corresponde diretamente a nenhum procedimento no nível TAPI, no qual as funções de habilitar extensões específicas do dispositivo, selecionar características de linha e definir a detecção de tipo de mídia são incluídas na funcionalidade definida por lineOpen. No nível do TSPI, esses recursos adicionais são separados em TSPI_lineNegotiateExtVersion, TSPI_lineSetDefaultMediaDetection e TSPI_lineConditionalMediaDetection.