TSPI-Nachrichten
Dieser Abschnitt enthält eine Liste der Nachrichten in der Telefoniedienstanbieterschnittstelle (TSPI). Diese Meldungen 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 er eine LINEEVENT - oder PHONEEVENT-Rückruffunktion aufruft, je nachdem, ob der Dienstanbieter ein Ereignis für eine Leitung, einen Anruf oder ein Telefongerät meldet. Die LINEEVENT-Prozedur zum Melden von Ereignissen, die in einer Zeile oder einem Aufruf 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 eine Anforderung sind. Diese Ereignisse stehen im Gegensatz zu denen, die den Abschluss von Anforderungen von TAPI melden. Solche Vervollständigungsereignisse 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 zur Darstellung der Geräte verwendet wurden.
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 besteht eine sehr starke Übereinstimmung zwischen den Nachrichten, die auf DER TSPI-Ebene angezeigt werden, und denen, die auf TAPI-Ebene angezeigt werden. Dies sind die allgemeinen Regeln der Korrespondenz:
- Der Satz von Nachrichten ist nahezu identisch. Wenn Nachrichten übereinstimmen, werden 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 .
- Es werden keine dwCallbackInstance-Daten an den Rückruf übergeben.
- Die Parameter dwParam1, dwParam2 und dwParam3 sind normalerweise mit den entsprechenden Parametern für die TAPI-Nachricht identisch.
- Zeilenorientierte und anruforientierte Nachrichten werden an ein anderes Rückrufverfahren übergeben als telefonorientierte Nachrichten.
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 der status eines Objekts zu benachrichtigen. Diese Meldungen bieten das undurchsichtige TAPI-Objekthandle und einen Hinweis darauf, welche status Element geändert wurde. TAPI kann anschließend eine entsprechende "get status"-Funktion des Objekts aufrufen, um die vollständige status des Objekts abzurufen.
Wenn ein Ereignis auftritt, kann eine Nachricht an TAPI gesendet werden oder nicht. Für einige Ereignistypen, z. B. status Änderungen, gibt TAPI einen Satz von status Änderungen an, an denen sie interessiert ist. Dem Dienstanbieter wird empfohlen, die status Nachrichtenereignisse, die er meldet, auf die in diesem Satz enthaltenen Ereignisse zu beschränken. Dieser Grenzwert muss vom Dienstanbieter nicht eingehalten werden. Mit anderen Worten, es kann mehr Änderungen melden, als unbedingt erforderlich sind. Es sollte jedoch versuchen, das Limit aus Leistungsgründen einzuhalten.
Die LINE_REPLY Meldung wird nicht auf DER 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: