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 |
|