Função lineMonitorTones (tapi.h)
A função lineMonitorTones habilita e desabilita a detecção de tons de banda na chamada. Sempre que um tom especificado é detectado, uma mensagem é enviada ao aplicativo.
Sintaxe
LONG lineMonitorTones(
HCALL hCall,
LPLINEMONITORTONE const lpToneList,
DWORD dwNumEntries
);
Parâmetros
hCall
Manipule para a chamada em cujos tons de canal de voz devem ser monitorados. O estado de chamada de hCall pode ser qualquer estado , exceto ocioso.
lpToneList
Lista de tons a serem monitorados. Esse parâmetro é do tipo LINEMONITORTONE. Cada tom nesta lista tem um campo de marca definido pelo aplicativo que é usado para identificar tons individuais na lista para relatar uma detecção de tom. O monitoramento de tom em andamento é cancelado ou alterado chamando essa operação com NULL para lpToneList ou com outra lista de tons.
dwNumEntries
Número de entradas em lpToneList. Esse parâmetro será ignorado se lpToneList for NULL.
Retornar valor
Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:
LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_INVALTONE, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED.
Comentários
Essa função terá êxito se o monitoramento de tom tiver sido iniciado corretamente, não quando o monitoramento de tom for encerrado. O monitoramento de tom permanece em vigor até que seja explicitamente desabilitado chamando lineMonitorTones com outra lista de tom (ou NULL), 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 tons normalmente só podem ser detectados enquanto a chamada está no estado conectado . A detecção de tom normalmente requer recursos computacionais. Dependendo do provedor de serviços e de outras atividades que competem por esses recursos, o número de tons que podem ser detectados pode variar ao longo do tempo. Além disso, uma quantidade equivalente de recursos pode ser consumida para monitorar um único tom de frequência tripla versus três tons de frequência única. Se os recursos forem supercomprometidos, o erro LINEERR_RESOURCEUNAVAIL será retornado.
A função lineMonitorTones também é usada para detectar o silêncio. O silêncio é especificado como um tom com uma frequência de zero.
O monitoramento de tons em uma chamada em conferência aplica-se somente ao hConfCall, não às chamadas participantes individuais
Se o valor de erro LINEERR_INVALPOINTER for retornado, o parâmetro lpToneList especificado será inválido ou o valor especificado pelo parâmetro dwNumEntries será muito grande.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |