LINEEVENT-Rückruffunktion (tspi.h)
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 |