Condividi tramite

Funzione di callback LINEEVENT (tspi.h)

  • Articolo

Line_Event è una funzione di callback implementata da TAPI e fornita al provider di servizi come parametro per TSPI_lineOpen. Il provider di servizi chiama questa funzione per segnalare gli eventi che si verificano sulla riga o sulle chiamate sulla riga.

Il tipo LINEEVENT definisce un puntatore a questa funzione di callback. Line_Event è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

LINEEVENT Lineevent;

void Lineevent(
  HTAPILINE htLine,
  HTAPICALL htCall,
  DWORD dwMsg,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2,
  DWORD_PTR dwParam3
)
{...}

Parametri

htLine

Handle TAPI per la riga in cui si è verificato l'evento.

htCall

Handle TAPI per la chiamata in cui si è verificato l'evento se si tratta di un evento correlato alla chiamata. Per gli eventi correlati alla riga in cui non è presente alcuna chiamata, questo parametro è impostato su NULL.

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 HTAPILINE fornito a TSPI_lineOpen come parametro htLine . Include l'identificatore del messaggio e i parametri specifici dell'evento.

Questa funzione differisce dalla funzione di callback definita a livello TAPI in quanto separa i parametri di riga e chiamata. Entrambi i parametri vengono usati per alcuni messaggi. I set di messaggi che possono essere passati a questa procedura differiscono leggermente dal 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

Vedi anche

Completion_Proc

TSPI_lineOpen