função TSPI_lineMonitorDigits (tspi.h)

Artigo
03/13/2024

A função TSPI_lineMonitorDigits habilita e desabilita a detecção sem buffer de dígitos recebidos na chamada. Sempre que um dígito dos modos de dígito especificados é detectado, uma mensagem LINE_MONITORDIGITS é enviada ao aplicativo pelo TAPI, indicando qual dígito é detectado.

Sintaxe

LONG TSPIAPI TSPI_lineMonitorDigits(
  HDRVCALL hdCall,
  DWORD    dwDigitModes
);

Parâmetros

hdCall

O identificador para a chamada na qual os dígitos devem ser detectados. O estado de chamada de hdCall pode ser qualquer estado , exceto ocioso ou desconectado.

dwDigitModes

Os modos de dígito que devem ser monitorados. Um parâmetro dwDigitModes com um valor de 0 cancela o monitoramento de dígitos. O parâmetro dwDigitModes pode ter uma das constantes LINEDIGITMODE_.

Retornar valor

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

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALDIGITMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

Comentários

Essa função retorna zero (êxito) quando o monitoramento de dígitos é iniciado corretamente, não quando o monitoramento de dígitos é encerrado. O monitoramento de dígitos permanece em vigor até que seja explicitamente desabilitado por uma chamada para TSPI_lineMonitorDigits com dwDigitModes definido como zero ou até que a chamada faça a transição para ocioso. A função deve retornar zero quando o monitoramento de dígitos for cancelado (ou seja, quando o parâmetro dwDigitModes for zero). O provedor de serviços deve encerrar o monitoramento de dígitos quando a chamada ficar ociosa. O TAPI não chama espontaneamente TSPI_lineMonitorDigits para encerrar o monitoramento.

Embora essa função possa ser invocada em qualquer estado de chamada, os dígitos normalmente são detectados apenas enquanto a chamada está no estado conectado .

Sempre que um dígito é detectado, o provedor de serviços envia uma mensagem LINE_MONITORDIGITS para TAPI, passando o dígito detectado como um parâmetro. Se LINEDIGITMODE_DTMF e LINEDIGITMODE_DTMFEND estiverem definidos em dwDigitModes, as duas mensagens LINE_MONITORDIGITS serão enviadas para cada dígito.

O TAPI pode usar TSPI_lineMonitorDigits para habilitar ou desabilitar a detecção de dígitos não permitidos. Ele pode usar TSPI_lineGatherDigits para detecção de dígito em buffer. Depois que a coleta de dígitos em buffer for concluída, uma mensagem LINE_GATHERDIGITS será enviada. A detecção de dígitos armazenados em buffer e não armazenados em buffer pode ser habilitada na mesma chamada simultaneamente.