PHONEEVENT-Rückruffunktion (tspi.h)
Phone_Event eine Rückruffunktion, die von TAPI implementiert und dem Dienstanbieter als Parameter zum TSPI_phoneOpen bereitgestellt wird. Der Dienstanbieter ruft diese Funktion auf, um Ereignisse zu melden, die auf dem Telefon auftreten.
Der PHONEEVENT-Typ definiert einen Zeiger auf diese Rückruffunktion. Phone_Event ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
Syntax
PHONEEVENT Phoneevent;
void Phoneevent(
HTAPIPHONE htPhone,
DWORD dwMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2,
DWORD_PTR dwParam3
)
{...}
Parameter
htPhone
Das TAPI-Handle für das Telefon, auf dem das Ereignis aufgetreten ist.
dwMsg
Gibt die Art des Ereignisses an, das gemeldet wird. Die Interpretation der anderen Parameter erfolgt je nach dem durch 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 HTAPIPHONE-Wert , der an TSPI_phoneOpen als htPhone-Parameter angegeben wird. Sie enthält den Nachrichtenbezeichner und die spezifischen Parameter für das Ereignis.
Die Meldungen, die an diese Prozedur übergeben werden können, unterscheiden sich geringfügig von den Nachrichten zum entsprechenden Rückruf auf 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 |