TSPI-Nachrichten

Dieser Abschnitt enthält eine Liste der Nachrichten in der Telefoniedienstanbieterschnittstelle (Telefonie service Provider Interface, TSPI). Diese Nachrichten werden verwendet, um TAPI über das Auftreten asynchroner Ereignisse zu benachrichtigen, die spontan innerhalb des Dienstanbieters auftreten. Der Dienstanbieter übergibt diese Ereignisse an TAPI, indem ein LINEEVENT oder PHONEEVENT Rückruffunktion aufgerufen wird, je nachdem, ob der Dienstanbieter ein Ereignis auf einer Leitung, einem Anruf oder einem Telefongerät meldet. Die LINEEVENT- Prozedur zum Melden von Ereignissen, die in einer Zeile oder einem Anruf auftreten, wird dem Dienstanbieter zum Zeitpunkt des Öffnens der Zeile mit der TSPI_lineOpen-Funktion bereitgestellt. Die PHONEEVENT--Prozedur zum Melden von Ereignissen, die auf einem Telefon auftreten, wird mit der TSPI_phoneOpen-Funktion bereitgestellt.

Diese spontanen Ereignisse werden von TAPI in dem Sinne nicht angefordert, dass sie keine direkte Antwort auf jede Anfrage sind. Diese Ereignisse stehen im Gegensatz zu den Berichten über den Abschluss von Anforderungen von TAPI. Solche Abschlussereignisse werden über die ASYNC_COMPLETION Rückruffunktion gemeldet.

Die Parameterprofile für die spontanen Ereignisprozeduren enthalten Parameter, die das relevante Objekt identifizieren, für das das Ereignis gemeldet wird (Telefon, Leitung oder Anruf). Die Identifizierung erfolgt in Form eines undurchsichtigen Handles, dessen genaue Interpretation nicht von TSPI veröffentlicht wird. TAPI bestimmt intern die Beziehung zwischen diesen undurchsichtigen Handles und den Datenstrukturen, die für die Darstellung der Geräte verwendet werden.

Das Parameterprofil für spontane Ereignisprozeduren enthält auch einen Nachrichtenparameter, der den Typ der Nachricht identifiziert. Jeder Nachrichtentyp verfügt über eine entsprechende Definition, die die enthaltenen Handles zusammen mit anderen Parametern und deren Bedeutung bestimmt. Es gibt eine sehr starke Korrespondenz zwischen den Nachrichten, die auf DER TSPI-Ebene angezeigt werden, und denen, die auf TAPI-Ebene angezeigt werden. Dies sind die allgemeinen Korrespondenzregeln:

• Der Satz von Nachrichten ist nahezu identisch. Wenn Nachrichten übereinstimmen, wird derselbe Nachrichtenname und -wert auf TSPI-Ebene verwendet.
• Handles, die auf TSPI-Ebene angezeigt werden, sind die durch die TSPI-Spezifikation definierten undurchsichtigen Typen. Diese Typen (und ihre Interpretation) unterscheiden sich von denen auf TAPI-Ebene, obwohl sie sich auf dieselbe Geräteklasse beziehen. Wenn beispielsweise eine TAPI-Nachricht ein HLINE-Handle enthält, enthält die entsprechende TSPI-Nachricht in der Regel ein HTAPILINE- Handle.
• An den Rückruf werden keine dwCallbackInstance Daten übergeben.
• Die parameter dwParam1, dwParam2und dwParam3 parameter sind in der Regel identisch mit den entsprechenden Parametern für die TAPI-Nachricht.
• Linienorientierte und anruforientierte Nachrichten werden an eine andere Rückrufprozedur als telefonorientierte Nachrichten übergeben.

In diesem Abschnitt werden für jede Nachricht die folgenden Elemente aufgelistet:

• Der Zweck der Nachricht
• Die Rückrufprozedur, an die diese Nachricht übergeben wird
• Eine Beschreibung der Nachrichtenparameter
• Optionale Kommentare zur Verwendung der Nachricht
• Optionale Verweise auf andere Funktionen, Nachrichten und Datenstrukturen
• Optionale Kommentare, die diese Nachricht mit der TAPI-Schnittstelle vergleichen

Bestimmte Nachrichten werden verwendet, um TAPI über eine Änderung im Status eines Objekts zu benachrichtigen. Diese Meldungen stellen das tapI undurchsichtige Objekthandle und einen Hinweis darauf bereit, welches Statuselement sich geändert hat. TAPI kann anschließend eine entsprechende Funktion "Get status" des Objekts aufrufen, um den vollständigen Status des Objekts abzurufen.

Wenn ein Ereignis auftritt, wird eine Nachricht möglicherweise oder nicht an TAPI gesendet. Bei einigen Ereignistypen, z. B. Statusänderungen, gibt TAPI eine Reihe von Statusänderungen an, an denen sie interessiert sind. Der Dienstanbieter wird empfohlen, die In diesem Satz enthaltenen Statusänderungsnachrichtenereignisse einzuschränken. Der Dienstanbieter ist nicht verpflichtet, diesen Grenzwert einzuhalten. Mit anderen Worten, sie kann mehr Änderungen melden, als unbedingt erforderlich sind. Es sollte jedoch versuchen, den Grenzwert aus Leistungsgründen zu beachten.

Die LINE_REPLY Nachricht wird nicht auf TSPI-Ebene verwendet. Der Abschluss einer asynchronen Anforderung wird mithilfe des ASYNC_COMPLETION Rückrufs gemeldet.

Die PHONE_REPLY Nachricht wird nicht auf TSPI-Ebene verwendet. Der Abschluss einer asynchronen Anforderung wird mithilfe des ASYNC_COMPLETION Rückrufs gemeldet.

Weitere Informationen finden Sie in den folgenden Themen:

• TSPI Line Device Messages
• TSPI-Gerätenachrichten