Inhaltsverzeichnis
Werbung
Kontrollbefehl select_rtc
Funktion
Definiert die für ein Anwenderprogramm aktive RTC
(siehe
Kapitel 6.6, Seite
Aufruf
NoOfSelectedCard = select_rtc( CardNo )
Parameter
CardNo
Rückgabe
Der Rückgabewert (32-Bit-Wert ohne Vorzeichen) ist:
• CardNo, wenn für die angegebene Karte eine Zugriffsberechtigung vorliegt oder wenn
die angegebene Karte nicht durch ein anderes Anwenderprogramm belegt ist (im letz-
teren Fall wird die Zugriffsberechtigung durch select_rtc – wie mit
verschafft, s.u.).
• Die Nummer der aktiven Karte, wenn CardNo die Zahl der bei der Initialisierung gefun-
denen RTC
• 0 sonst (also insbesondere dann, wenn die angegebene Karte durch ein anderes
Anwenderprogramm reserviert ist und die Aktivierung der Karte deswegen oder wegen
eines Versionsfehlers nicht erfolgreich durchgeführt werden kann) (get_last_error-
Returncode RTC5_ACCESS_DENIED und gegebenenfalls RTC5_VERSION_MISMATCH ).
Hinweise
• Die Aktivierung einer Karte für ein Anwenderprogramm wird auch bereits bei der Initi-
alisierung der DLL für dieses Anwenderprogramm ausgeführt (siehe init_rtc5_dll). Der
Befehl select_rtc ermöglicht aber zusätzlich jederzeit einen Wechsel der aktiven Karte.
Alle dem Befehl select_rtc nachfolgenden Befehle (außer Multi-Board-Befehle) des
Anwenderprogramms werden an die jeweils aktive Karte weitergeleitet.
• Falls die angegebene Karte durch eine anderes Anwenderprogramm reserviert ist, bleibt
select_rtc wirkungslos (Rückgabewert 0, get_last_error-Returncode
RTC5_ACCESS_DENIED).
• Falls für die angegebene Karte keine Zugriffsberechtigung vorliegt, diese aber auch
nicht durch ein anderes Anwenderprogramm belegt ist, so wird die Karte nicht nur akti-
viert, sondern auch automatisch (wie mit acquire_rtc) – bei positiver Versionsprüfung
(s.u.) – für dieses Anwenderprogramm reserviert und damit für andere Anwenderpro-
gramme gesperrt (Rückgabewert: CardNo). Beim Akquirieren der Karte wird (wie mit
acquire_rtc) eine Versionsprüfung durchgeführt. Liegt ein Versionsfehler vor, wird der
Zugriff auf die Karte verweigert und select_rtc bleibt wirkungslos (Rückgabewert 0,
get_last_error-Returncode RTC5_ACCESS_DENIED|RTC5_VERSION_MISMATCH).
• Falls die angegebene Karte bereits die aktive Karte für dieses Anwenderprogramm ist,
bleibt select_rtc wirkungslos (Rückgabewert: CardNo).
• Der Befehl select_rtc bleibt auch wirkungslos, wenn CardNo die Zahl der bei der Initia-
lisierung gefundenen RTC
CardNo = 0 ist (reale Karten zählen ab 1). Rückgabewert ist dann die Nummer der
aktiven Karte (s.o.). Mit select_rtc( 0 ) lässt sich dadurch jederzeit die Nummer der
aktiven Karte ermitteln.
• Der Befehl select_rtc ist auch ohne explizite Zugriffsberechtigung für irgendeine
®
RTC
• Der Befehl select_rtc ist nicht als Multi-Board-Befehl verfügbar.
®
®
RTC
4 RTC
5 Bei der RTC
aus.
Bei der RTC
Zugriffsberechtigung für die angegebene Karte u.U. zusätzlich (wie mit dem Befehl
acquire_rtc) die Zugriffsberechtigung oder bleibt wirkungslos.
®
®
RTC
5 PCI-Karte, RTC
5 PCI-Express-Karte, RTC
Rev. 1.10 d
10 Befehle und Funktionen
90).
(DLL-interne) Nummer der RTC
®
5-Karten übersteigt oder für CardNo = 0.
®
5-Karten (siehe rtc5_count_cards) übersteigt oder wenn
5-Karte verfügbar.
®
4 führt dieser Befehl nur die Aktivierung der angegebenen Karte (unbedingt)
®
5 liefert der Befehl zusätzlich einen Rückgabewert und erteilt bei fehlender
®
5 PC/104-Plus-Karte, RTC
®
5-Karte in einem Multi-Board-System
®
5-Karte als 32-Bit-Wert ohne Vorzeichen.
®
5 PCIe/104-Karte
acquire_rtc
–
449
Werbung
Inhaltsverzeichnis
