Condividi tramite


messaggio LINE_GATHERDIGITS

Il messaggio TAPI LINE_GATHERDIGITS viene inviato quando la richiesta di raccolta delle cifre memorizzata nel buffer corrente è stata terminata o viene annullata. Il buffer delle cifre può essere esaminato dopo che il messaggio è stato ricevuto dall'applicazione.

            

Parametri

hDevice

Handle per la chiamata.

dwCallbackInstance

Istanza di callback specificata all'apertura della riga.

dwParam1

Motivo per cui la raccolta di cifre è stata terminata. Questo parametro deve essere uno e solo una delle costanti LINEGATHERTERM_.

dwParam2

Non utilizzato.

dwParam3

Numero di tick (numero di millisecondi dall'avvio di Windows) in cui la raccolta di cifre è stata completata. Per le versioni TAPI precedenti alla 2.0, questo parametro non è usato.

Valore restituito

Nessun valore restituito.

Commenti

Il messaggio LINE_GATHERDIGITS viene inviato solo all'applicazione che ha avviato la raccolta di cifre nella chiamata usando lineGatherDigits.

Se la funzione lineGatherDigits viene usata per annullare una richiesta precedente per raccogliere cifre, TAPI invia un messaggio di LINE_GATHERDIGITS con dwParam1 impostato su LINEGATHERTERM_CANCEL all'applicazione che indica che il buffer specificato originariamente contiene le cifre raccolte fino all'annullamento.

Poiché il timestamp specificato da dwParam3 potrebbe essere stato generato in un computer diverso da quello in cui è in esecuzione l'applicazione, è utile solo per il confronto con altri messaggi con timestamp simili generati sullo stesso dispositivo di riga ( LINE_GENERATE, LINE_MONITORDIGITS, LINE_MONITORMEDIA, LINE_MONITORTONE), per determinare la tempistica relativa (separazione tra eventi). Il conteggio dei tick può "avvolgere" dopo circa 49,7 giorni; quando si eseguono calcoli, le applicazioni devono tenere presente questa situazione.

Se il provider di servizi non genera il timestamp (ad esempio, se è stato creato usando una versione precedente di TAPI), TAPI fornisce un timestamp al punto più vicino al provider di servizi che genera l'evento in modo che il timestamp sintetizzato sia il più accurato possibile.

Nota

Quando un'applicazione richiama qualsiasi operazione asincrona che scrive di nuovo i dati nella memoria dell'applicazione, l'applicazione deve mantenere tale memoria disponibile per la scrittura fino a quando non viene ricevuto un messaggio LINE_REPLY o LINE_GATHERDIGITS .

Requisiti

Requisito Valore
Versione TAPI
Richiede TAPI 2.0 o versione successiva
Intestazione
Tapi.h

Vedi anche

LINE_GENERATE

LINE_MONITORDIGITS

LINE_MONITORMEDIA

LINE_MONITORTONE

LINE_REPLY

lineGatherDigits