Vorbereitungen

In diesem Kapitel möchte ich am Beispiel einer Delphi-Komponente die Grundlagen der CAPI-Programmierung aufzeigen. Ergebnis dieses kleinen Projektes wird eine Komponente für Delphi 3 sein, die bei einem ankommenden Anruf die Nummer des Anrufers liefert. Mit Hilfe dieser Komponente oder persönlichen Erweiterungen, können Sie endlich Ihren Lieblings-Anrufmonitor schreiben. Wenn Sie alle Schritte nachvollziehen wollen, sollten Sie folgendes zur Hand haben:

• Windows 95 mit einer ISDN-Karte oder einem externen ISDN-Adapter und einem installierten 32-Bit Capi-Treiber (CAPI2032.DLL).
• Ein installiertes und funktionsfähiges Delphi 3.
• Die Dokumentation zur CAPI 2.0. Die Dokumentation finden Sie als PDF-Dateien z.B. unter http://www.capi.org.
• Den Adobe Acrobat Reader ab 3.0 zum Lesen der PDF-Dateien. Den finden Sie dort auch.
• Die Sourcen zum Projekt. Die Sourcen finden Sie im Archiv SRCISDN.ZIP. Die beiliegende README.TXT beschreibt, wie Sie die Komponenten in Delphi aufnehmen.

Um Ihnen das Ganze noch ein wenig schmackhaft zu machen, hier der gesamte Code, der im Beispielprojekt nötig war, um die Rufnummer von der Komponente zu bekommen und anzuzeigen:

procedure TForm1.FormCreate(Sender: TObject);
var Controller : dWord;
begin
  Controller := 1;
  CapiMonitor1.WaitForCall(Controller, 0);
end;
procedure TForm1.CapiMonitor1IncomingCall(CallingPartyNumber: string;
                                          CalledPartyNumber : string;
                                          CipValue : word;
                                          CipValueString : string);
begin
  lblRufnummer.Caption := TimeToStr(Time) + ':  ' + CallingPartyNumber;
end;

Wenn Sie auch noch wissen wollen, wie das Ganze funktioniert, sollten Sie sich die folgenden Abschnitte ansehen. Wenn ab jetzt von der (eigentlich heißt es ja "dem") CAPI gesprochen wird, ist immer der Treiber gemeint, während sich CAPI Doku. auf das Dokument bezieht, das die Schnittstelle definiert, die der Treiber für die Anwendung bereitstellt.

Noch eine kurze Bemerkung zum Schluß der Vorbereitungen:

Ich habe das Programm auf meinem Rechner entwickelt und auch getestet. Damit kann ich natürlich nicht gewährleisten, dass bei Ihnen alles fehlerfrei läuft. Wenn Sie auf ein Problem stoßen oder einen Fehler finden, wäre ich Ihnen sehr verbunden, wenn Sie mir Bescheid sagen würden..