Aufruf der CAPI-Funktionen

Bevor auf die Details des Datenaustausches zwischen Anwendung und CAPI eingegangen wird, wollen wir zunächst klären, wie man die Funktionen überhaupt nutzt.

Für 32-Bit-Programme unter Windows 95 oder Windows NT stellt die CAPI2032.DLL die Funktionen der CAPI für die Anwendungen zur Verfügung. Welche Funktionen das sind, steht in der CAPI Doku. beschrieben (dort sind sie als Operations bezeichnet, siehe CAPI Doku. Kapitel 4.3 Table of Operations). Grundsätzlich muss jeder CAPI-Treiber diese Funktionen bereitstellen. Es gibt aber auch Ausnahmen wie z.B. die Funktion CAPI_WAIT_FOR_SIGNAL, die zwar z.B. durch die CAPI2032.DLL unter Windows 95 bereitgestellt wird, nicht aber durch die CAPI20.DLL unter Windows 3.11. Wie diese Funktionen aufgerufen werden, ist betriebssystemspezifisch. Da es unter DOS z.B. keine DLLs gibt, müssen die Funktionen auf eine andere Weise (über den Interrupt F1h) ausgeführt werden.

Aus diesem Grund teilt sich die CAPI Doku. auch in einen allgemeinen und einen betriebssystemspezifischen Teil.

• Der allgemeine Teil beschreibt, welche Funktionen und Funktionsparameter (CAPI-Messages) es gibt.
• Der betriebssystemspezifische Teil erläutert, wie unter verschiedenen Betriebssystemen und "Kommunikationsszenarien" auf die Funktionen zugegriffen wird und wie die Funktionen deklariert sind.

Im Beispielprojekt übernimmt es die Unit CPDLL.PAS, die Funktionen aus der CAPI2032.DLL für das Programm verfügbar zu machen. Um die Funktionen in der CPDLL.PAS richtig deklarieren zu können, ist ein Blick in den betriebssystemspezifischen Teil der CAPI Doku. notwendig (PART II, Operating Systems). Im Kapitel "Windows 95 (Application Level)" verweist die CAPI Doku. auf das Kapitel "Windows NT (Application Level)", wo Sie schließlich die Informationen finden, um die Funktionen im Programm richtig zu deklarieren (siehe CPDLL.PAS, Capi-Funktions-Prototypen im Interface-Teil der Unit).

• In der Funktion CapiInitDLL wird die CAPI2032.DLL geladen (LoadLibrary) und über die Windows API-Funktion GetProcAddress ein Zeiger auf die jeweilige Funktion ermittelt.
• Wie die Funktion dann aufgerufen wird, sehen Sie z.B. in der Unit CPHAND.PAS, wenn Sie sich das Ende der Funktion TCapi.PutMessage ansehen.
• Im finalization-Teil der Unit wird bei Programmende die DLL wieder freigegeben.

Das Beispielprojekt CAPIINFO.DPR (enthalten in SRCISDN.ZIP, siehe Vorbereitungen) zeigt, wie man dem CAPI Informationen über den ISDN-Controller und die CAPI selbst entlocken kann. CAPIINFO.DPR verwendet dazu die Komponente, TCapiInfo, die vor dem Laden des Projekts in der Komponentenpalette von Delphi registriert werden mu (siee Vorbereitungen).