LINEEVENT-Rückruffunktion (tspi.h)

  • Artikel

Line_Event ist eine Rückruffunktion, die von TAPI implementiert und dem Dienstanbieter als Parameter für TSPI_lineOpen bereitgestellt wird. Der Dienstanbieter ruft diese Funktion auf, um Ereignisse zu melden, die in der Leitung oder bei Aufrufen der Leitung auftreten.

Der LINEEVENT-Typ definiert einen Zeiger auf diese Rückruffunktion. Line_Event ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

LINEEVENT Lineevent;

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

Parameter

htLine

Das TAPI-Handle für die Zeile, in der das Ereignis aufgetreten ist.

htCall

Das TAPI-Handle für den Aufruf, an dem das Ereignis aufgetreten ist, wenn es sich um ein anrufbezogenes Ereignis handelt. Bei zeilenbezogenen Ereignissen, bei denen kein Aufruf erfolgt, ist dieser Parameter auf NULL festgelegt.

dwMsg

Gibt die Art des ereignisses an, das gemeldet wird. Die Interpretation der anderen Parameter erfolgt je nach dem von dwMsg angegebenen Kontext auf unterschiedliche Weise.

dwParam1

Ein Parameter für die Nachricht.

dwParam2

Ein Parameter für die Nachricht.

dwParam3

Ein Parameter für die Nachricht.

Rückgabewert

Keine

Bemerkungen

Der Aufrufzustand beim Aufrufen dieser Funktion kann ein beliebiger Zustand sein.

Der Dienstanbieter übergibt den angegebenen HTAPILINE-Wert an TSPI_lineOpen als htLine-Parameter . Sie enthält den Nachrichtenbezeichner und die für das Ereignis spezifischen Parameter.

Diese Funktion unterscheidet sich von der auf TAPI-Ebene definierten Rückruffunktion dadurch, dass sie Zeilen- und Aufrufparameter trennt. Beide Parameter werden für einige Nachrichten verwendet. Die Sätze von Nachrichten, die an diese Prozedur übergeben werden können, unterscheiden sich geringfügig von der TAPI-Ebene. Insbesondere wird der Abschluss der asynchron ausgeführten Anforderungen über den Completion_Proc Rückruf anstelle dieses gemeldet.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tspi.h

Weitere Informationen

Completion_Proc

TSPI_lineOpen