LINE_GENERATE messaggio
Il messaggio TAPI LINE_GENERATE viene inviato per notificare all'applicazione che la generazione corrente di cifre o toni è stata terminata. Una sola richiesta di generazione può essere in corso in una determinata chiamata in qualsiasi momento. Questo messaggio viene inviato anche quando viene annullata la generazione di cifre o toni.
Parametri
-
hDevice
-
Handle per la chiamata.
-
dwCallbackInstance
-
Istanza di callback fornita all'apertura della riga.
-
dwParam1
-
Motivo per cui la generazione di cifre o toni è stata terminata. Questo parametro deve essere uno e solo una delle costanti LINEGENERATETERM_.
-
dwParam2
-
Non utilizzato.
-
dwParam3
-
Numero di tick (numero di millisecondi dall'avvio di Windows) in cui è stata completata la generazione della cifra o del tono. Per le versioni api precedenti alla 2.0, questo parametro non è usato.
Valore restituito
Nessun valore restituito.
Osservazioni:
Il messaggio LINE_GENERATE viene inviato solo all'applicazione che ha richiesto la generazione della cifra o del tono.
Poiché il timestamp specificato da dwParam3 può 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 nello stesso dispositivo linea ( LINE_GATHERDIGITS, 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; le applicazioni devono tenere conto di questo quando si eseguono calcoli.
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.
Requisiti
| Requisito | valore |
|---|---|
| Versione TAPI |
Richiede TAPI 2.0 o versione successiva |
| Intestazione |
|