Inhaltsverzeichnis
Werbung
6.2.5 Beispiel-Code
Der grundsätzliche Aufbau eines Anwenderpro-
grammes zur Initialisierung der DLL und der RTC
im Folgenden beispielhaft als C-Quellcode für eine
Konsolenanwendung (Win32-Umgebung) dargestellt
(für komplette Demoprogramme siehe
Benötigte Dateien: RTC5impl.h, RTC5DLL.LIB (bei
implizitem Linken) bzw. RTC5expl.h, RTC5expl.c (bei
explizitem Linken). Zusätzlich muss die DLL vom
Programm aufgerufen werden (siehe
das Betriebssystem die RTC5DLL.DLL beim Programm-
Startup nicht findet, antwortet es mit einer entspre-
chenden Fehlermeldung und beendet das Programm.
// System-Kopfdateien
#include <windows.h>
#include <stdio.h>
#include <conio.h>
®
// RTC
5 Kopfdatei zum impliziten Linken zur RTC5DLL.DLL (linken Sie zusätzlich mit der (Visual C++) Import-Bibliothek
// RTC5DLL.LIB, um eine ausführbare Datei zu erzeugen):
#include "RTC5impl.h"
®
// Alternativ: RTC
5 Kopfdatei zum expliziten Linken zur RTC5DLL.DLL (linken Sie zusätzlich mit der Datei RTC5EXPL.OBJ, die
// Sie aus dem Quellcode der Datei RTC5expl.c generieren können, um eine ausführbare Datei zu erzeugen):
//#include "RTC5expl.h"
void __cdecl main( void*, void* )
{
// nur bei explizitem Linken:
// if ( RTC5open() ) // Fehler detektiert (RTC5open gibt 0 zurück, wenn kein Fehler auftritt)
// {
// printf( "Error: RTC5DLL.DLL not found\n" );
// terminateDLL();
// return;
// }
printf( "Initializing the DLL\n\n" );
UINT ErrorCode;
// Initialisierung der DLL (der folgende Befehl sollte als erster RTC
ErrorCode = init_rtc5_dll();
// Direkt auf den init_rtc5_dll-Befehl sollte ein Programmteil eingebaut werden, mit dem ein Fehler während der
// Initialisierung aufgefangen wird, z. B. für den Fall, dass die gewünschte RTC
// Zugriff verweigert wird oder wenn ein weiterer Fehler (z. B. ein VersionMismatch-Fehler auftritt. Ein entsprechender
// Beispielcode ist auf
Kapitel 6.8.3 "Beispiel-Code", Seite 97
®
// Initialisierung der RTC
5:
®
// - Auswählen der RTC
5-Karte Nummer 1 als die aktive RTC
// - Falls gewünscht: Auswählen des RTC
// - Stoppen einer eventuellen Listenausführung auf der RTC
// Anwenderprogramm verwendet wurde, könnte noch eine Liste laufen (ausgeführt werden).
//
load_correction_file
könnten dann nicht ausgeführt werden).
// - Aufrufen von
load_program_file
// eventuell auftretende Fehler – z. B. Datei- oder System-Fehler – durch einen geeigneten Programmcode aufgefangen
// werden, siehe
Kapitel 6.8.3 "Beispiel-Code", Seite
// - Zurücksetzen aller vorherigen Fehlercodes (stop_execution könnte einen RTC5_TIMEOUT- oder RTC5_BUSY-Fehler
// verursacht haben)
®
// - Konfigurieren des RTC
®
®
RTC
5 PCI-Karte, RTC
5 PCI-Express-Karte, RTC
Rev. 1.10 d
6 Programmierung von Anwenderprogrammen
®
5 ist
Seite
632).
Seite
66). Falls
®
4-Kompatibilitätsmodus als Betriebsmodus (Default: RTC
zum Resetten der Karte, zum Laden der Programmdatei, etc. (auch hier sollten
97)
5-Listenspeichers, Default: 4000 Speicherplätze für Liste 1, 4000 für Liste 2).
®
5 PC/104-Plus-Karte, RTC
®
5 Befehl aufgerufen werden)
®
5-Karte nicht gefunden wird, wenn der
aufgeführt.
®
5-Karte diesem Anwenderprogramm
®
5-Karte Nummer 1 falls diese Karte zuvor durch ein anderes
®
5 PCIe/104-Karte
®
5-Modus)
load_program_file
und
71
Werbung
Inhaltsverzeichnis
