Funzione di callback PHONEEVENT (tspi.h)
Phone_Event una funzione di callback implementata da TAPI e fornita al provider di servizi come parametro per TSPI_phoneOpen. Il provider di servizi chiama questa funzione per segnalare gli eventi che si verificano sul telefono.
Il tipo PHONEEVENT definisce un puntatore a questa funzione di callback. Phone_Event è un segnaposto per il nome della funzione definita dall'applicazione.
Sintassi
PHONEEVENT Phoneevent;
void Phoneevent(
HTAPIPHONE htPhone,
DWORD dwMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2,
DWORD_PTR dwParam3
)
{...}
Parametri
htPhone
Handle TAPI per il telefono in cui si è verificato l'evento.
dwMsg
Specifica il tipo di evento segnalato. L'interpretazione degli altri parametri viene eseguita in modi diversi in base al contesto indicato da dwMsg.
dwParam1
Parametro per il messaggio.
dwParam2
Parametro per il messaggio.
dwParam3
Parametro per il messaggio.
Valore restituito
nessuno
Osservazioni
Lo stato della chiamata quando si chiama questa funzione può essere qualsiasi stato.
Il provider di servizi passa il valore HTAPIPHONE fornito a TSPI_phoneOpen come parametro htPhone . Include l'identificatore del messaggio e i parametri specifici dell'evento.
I set di messaggi che possono essere passati a questa procedura differiscono leggermente dai messaggi al callback corrispondente a livello TAPI. In particolare, il completamento delle richieste in esecuzione asincrona viene segnalato tramite il callback Completion_Proc anziché questo.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |