Função lineMonitorDigits (tapi.h)

Artigo
03/05/2024

A função lineMonitorDigits habilita e desabilita a detecção sem buffer de dígitos recebidos na chamada. Cada vez que um dígito do modo de dígito especificado é detectado, uma mensagem é enviada ao aplicativo indicando qual dígito foi detectado.

Sintaxe

LONG lineMonitorDigits(
  HCALL hCall,
  DWORD dwDigitModes
);

Parâmetros

hCall

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

dwDigitModes

Modo de dígito ou modos que devem ser monitorados. Se dwDigitModes for zero, o monitoramento de dígito será cancelado. Esse parâmetro usa uma ou mais das constantes LINEDIGITMODE_.

Retornar valor

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

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

Comentários

Essa função será considerada bem-sucedida se o monitoramento de dígitos tiver sido iniciado corretamente, não quando o monitoramento de dígitos for encerrado. O monitoramento de dígitos permanece em vigor até que seja explicitamente desabilitado chamando lineMonitorDigits com dwDigitModes definido como zero, até que a chamada faça a transição para ocioso ou quando o aplicativo desalocar seu identificador de chamada para a chamada. Embora essa função possa ser invocada em qualquer estado de chamada, os dígitos geralmente são detectados apenas enquanto a chamada está no estado conectado .

Sempre que um dígito é detectado, uma mensagem de LINE_MONITORDIGITS é enviada ao aplicativo passando o dígito detectado como um parâmetro.

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

O monitoramento de dígitos em uma chamada em conferência aplica-se somente ao hConfCall, não às chamadas individuais participantes.