função TSPI_lineMonitorDigits (tspi.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |