funzione TSPI_lineMonitorDigits (tspi.h)

Articolo
03/03/2024

La funzione TSPI_lineMonitorDigits abilita e disabilita il rilevamento non memorizzato delle cifre ricevute nella chiamata. Ogni volta che viene rilevata una cifra della modalità cifre specificata, viene inviato un messaggio di LINE_MONITORDIGITS all'applicazione da TAPI, che indica quale cifra viene rilevata.

Sintassi

LONG TSPIAPI TSPI_lineMonitorDigits(
  HDRVCALL hdCall,
  DWORD    dwDigitModes
);

Parametri

hdCall

Handle per la chiamata su cui rilevare le cifre. Lo stato della chiamata di hdCall può essere qualsiasi stato, ad eccezione dell'inattività o disconnesso.

dwDigitModes

Modalità cifre da monitorare. Parametro dwDigitModes con un valore pari a 0 annulla il monitoraggio delle cifre. Il parametro dwDigitModes può avere una delle costanti LINEDIGITMODE_.

Valore restituito

Restituisce zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:

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

Commenti

Questa funzione restituisce zero (esito positivo) quando il monitoraggio delle cifre viene avviato correttamente, non quando il monitoraggio delle cifre viene terminato. Il monitoraggio delle cifre rimane attivo finché non viene disabilitato in modo esplicito da una chiamata a TSPI_lineMonitorDigits con dwDigitModes impostato su zero o fino a quando la chiamata passa all'inattività. La funzione deve restituire zero quando il monitoraggio delle cifre viene annullato, ovvero quando il parametro dwDigitModes è zero. Il provider di servizi deve terminare il monitoraggio delle cifre quando la chiamata va inattiva. TAPI non chiama spontaneamente TSPI_lineMonitorDigits per terminare il monitoraggio.

Anche se questa funzione può essere richiamata in qualsiasi stato di chiamata, le cifre vengono in genere rilevate solo mentre la chiamata si trova nello stato connesso .

Ogni volta che viene rilevata una cifra, il provider di servizi invia un messaggio LINE_MONITORDIGITS a TAPI, passando la cifra rilevata come parametro. Se sia LINEDIGITMODE_DTMF che LINEDIGITMODE_DTMFEND sono impostati in dwDigitModes, i due messaggi di LINE_MONITORDIGITS vengono inviati per ogni cifra.

TAPI può usare TSPI_lineMonitorDigits per abilitare o disabilitare il rilevamento delle cifre non memorizzate. Può usare TSPI_lineGatherDigits per il rilevamento delle cifre memorizzate nel buffer. Al termine della raccolta di cifre memorizzate nel buffer, viene inviato un messaggio LINE_GATHERDIGITS . È possibile abilitare sia il rilevamento delle cifre memorizzate nel buffer sia nella stessa chiamata.