Condividi tramite


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
Tapi.h

Vedi anche

LINE_GATHERDIGITS

LINE_MONITORDIGITS

LINE_MONITORMEDIA

LINE_MONITORTONE