funzione lineMonitorDigits (tapi.h)

Articolo
08/26/2023

La funzione 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 all'applicazione che indica quale cifra è stata rilevata.

Sintassi

LONG lineMonitorDigits(
  HCALL hCall,
  DWORD dwDigitModes
);

Parametri

hCall

Gestire la chiamata su quali cifre devono essere rilevate. Lo stato della chiamata di hCall può essere qualsiasi stato tranne inattivo o disconnesso.

dwDigitModes

Modalità cifre o modalità da monitorare. Se dwDigitModes è zero, il monitoraggio delle cifre viene annullato. Questo parametro usa una o più costanti LINEDIGITMODE_.

Valore restituito

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

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

Commenti

Questa funzione viene considerata corretta se il monitoraggio delle cifre è stato avviato correttamente, non quando il monitoraggio delle cifre è terminato. Il monitoraggio delle cifre rimane attivo finché non viene disabilitato in modo esplicito chiamando lineMonitorDigits con dwDigitModes impostato su zero, fino a quando la chiamata passa all'inattività o quando l'applicazione dealloca il relativo handle di chiamata per la chiamata. 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, viene inviato un messaggio di LINE_MONITORDIGITS all'applicazione passando la cifra rilevata come parametro.

Un'applicazione può usare lineMonitorDigits per abilitare o disabilitare il rilevamento delle cifre non memorizzate. Può usare lineGatherDigits per il rilevamento delle cifre memorizzate nel buffer. Al termine della raccolta di cifre memorizzate nel buffer, viene inviato un messaggio LINE_GATHERDIGITS all'applicazione. È possibile abilitare sia il rilevamento delle cifre memorizzate nel buffer sia nella stessa chiamata.

Il monitoraggio delle cifre in una chiamata di conferenza si applica solo all'hConfCall, non alle singole chiamate che partecipano.