Inhaltsverzeichnis
Werbung
Kontrollbefehl init_rtc5_dll
Funktion
Initialisiert die Ansteuerung der installierten RTC
Aufruf
InitErrorNo = init_rtc5_dll()
Rückgabe
Fehlercode als 32-Bit-Wert ohne Vorzeichen.
Sind mehrere Fehler gleichzeitig aufgetreten, so sind mehrere Bits gesetzt.
Die Zuordnung zwischen Bitnummern, Fehlertypen und Fehlerkonstanten ist identisch wie
beim Befehl get_error.
Hinweise
• Der Befehl init_rtc5_dll muss von jedem Anwenderprogramm zu Beginn aufgerufen
werden, damit von dem Anwenderprogramm überhaupt eine RTC
ansprechbar ist. init_rtc5_dll sucht nach sämtlichen vorhandenen RTC
baut die entsprechende Verwaltung auf. Wird keine RTC
Fehlercode RTC5_NO_CARD zurückgegeben.
• Wenn beim Lesen des PCI-Konfigurationsregisters ein Fehler aufgetreten ist
(get_last_error-Returncode RTC5_CONFIG_ERROR), wird auch der Fehler
RTC5_ACCESS_DENIED erzeugt. Auf die Karte kann dann so lange nicht mehr zugegriffen
werden, bis nach einem PC-Neustart der Fehler beseitigt ist.
• Der Befehl init_rtc5_dll vergibt dem Anwenderprogramm automatisch wie mit
acquire_rtc
rechtigung nicht bereits an ein anderes Anwenderprogramm vergeben wurde (es
können zwar beliebig viele RTC
verwendet werden, ein und dieselbe Karte kann aber nicht gleichzeitig von mehreren
Anwenderprogrammen verwendet werden). Die erste Initialisierung akquiriert alle
gefundenen Karten für sich. Bei nachfolgenden, durch andere Anwenderprogramme
gestarteten Initialisierungen liefert der Befehl init_rtc5_dll dann den Fehlercode
RTC5_ACCESS_DENIED zurück. Die Karten sind dann von diesen Anwenderprogrammen
nur mit ausschließlich DLL-intern wirkenden Funktionen ansprechbar, die keine Zugriffs-
berechtigung erfordern – z.B. mit get_error,
meisten Multi-Board-Befehle sind nur auf zugriffsberechtigten Karten ausführbar). Hat
ein Anwenderprogramm die Zugriffsberechtigung für eine Karte erhalten, dann kann
diese Karte erst dann wieder – mit init_rtc5_dll oder
Anwenderprogramm beansprucht werden, nachdem die Karte mit
free_rtc5_dll
wurde.
Der Fehlercode RTC5_ACCESS_DENIED wird zurückgegeben, wenn mindestens eine der
gefundenen Karten den Zugriff verweigert hat. Welche das ist oder sind, kann mit
get_error(CardNo) (CardNo von 1 bis zur Zahl der gefundenen Karten) oder unmit-
telbar nach init_rtc5_dll (noch vor dem ersten anderen Befehl) mit
get_last_error(CardNo) abgefragt werden.
• Beim Akquirieren einer Karte durch init_rtc5_dll wird (wie mit acquire_rtc) eine
Versionsprüfung durchgeführt. Liegt ein Versionsfehler vor, wird der Zugriff auf die
Karte verweigert (Rückgabewert RTC5_ACCESS_DENIED|RTC5_VERSION_MISMATCH).
• Es kann zur gleichen Zeit immer nur ein einziges Anwenderprogramm die Initialisierung
durchführen. Durch andere Anwenderprogramme später gestartete Initialisierungen
warten, bis die aktuelle Initialisierung abgelaufen ist.
• Wird der Befehl init_rtc5_dll von demselben Anwenderprogramm mehrmalig aufge-
rufen, so wird die beim vormaligen Aufruf des Befehls aufgebaute Kartenverwaltung für
dieses Anwenderprogramm gelöscht und die dabei an das Anwenderprogramm verge-
benen Zugriffsberechtigungen aufgehoben, ehe die neue Kartenverwaltung aufgebaut
wird und wieder neue Zugriffsberechtigungen erteilt werden.
®
®
RTC
5 PCI-Karte, RTC
5 PCI-Express-Karte, RTC
Rev. 1.10 d
10 Befehle und Funktionen
die Zugriffsberechtigung für die gefundenen Karten, sofern die Zugriffsbe-
®
5-Karten oder Anwenderprogramme gleichzeitig
explizit vom zugriffsberechtigten Anwenderprogramm freigegeben
®
®
5 PC/104-Plus-Karte, RTC
5 PCIe/104-Karte
®
5-Karten für ein Anwenderprogramm.
®
5-Karte
®
®
5-Karte gefunden, wird der
get_last_error
oder
select_rtc
acquire_rtc
– von einem anderen
release_rtc
5-Karten und
(auch die
oder
339
Werbung
Inhaltsverzeichnis
