PHONEEVENT-Rückruffunktion (tspi.h)

  • Artikel

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

Weitere Informationen

Completion_Proc

TSPI_lineOpen