Inhaltsverzeichnis
Werbung
IBS PCI DDK UM
5-14
5.3.5
Prozessdaten lesen (readDTI)
Der Ablauf beim Lesen aus der Data-Area entspricht dem beim Schreiben
in die DTA. Lediglich die Richtung des Datentransfers wird geändert.
Mit Hilfe der readDTI-Funktion werden Daten aus der Data-Area (DTA)
eines anderen oder auch des eigenen Nodes gelesen. Der Node-Handle
bestimmt, von welchem Node gelesen wird.
Die Funktion besteht im Wesentlichen aus der Überprüfung der in der
Struktur T_DDI_DTI_ACCESS übergebenen Parameter und dem Kopie-
ren der Daten aus dem gewünschten Bereich in einen vom Anwendungs-
programm bereitgestellten Speicherbereich.
Folgende Überprüfungen werden durchgeführt:
–
Zustand der Kontrollstruktur,
–
Zugriffsrecht auf den Datenkanälen vorhanden,
–
Interface-Typ gleich Data-Interface,
–
Einhaltung des zulässigen Bereiches der Data-Area beim Lesen der
Daten (Summe aus Offset und Anzahl der Bytes kleiner/gleich Data-
Area).
Kann einer der oben aufgeführten Punkte nicht erfüllt werden, wird die
Funktion mit einer Fehlermeldung beendet.
Werden alle Punkte erfüllt, folgt das Kopieren der Daten. Die Anfangs-
adresse ist wieder dem MPM-Deskriptor zu entnehmen. In einer Schleife
werden dann die Daten aus dem MPM gelesen.
Nach dem erfolgreichen Lesevorgang wird die Funktion mit dem Rückga-
bewert ERR_OK beendet.
6189A
Werbung
Kapitel
Inhaltsverzeichnis
