Inhaltsverzeichnis
Werbung
10.9 Veraltete Funktionen
10.9.1 Allgemeine Sensor Informationen erhalten
Befehl
int EthernetScanner_GetInfo(void *pEthernetScanner, char *chInfo, int iBuffer, char *ch-
Mode)
Parameter 1
void*: ein Handle zum Profilsensor, ausgegeben von der Funktion „EthernetScanner_Con-
nect"
Parameter 2
char*: Pointer auf einen Puffer (Typ „char"), in den die Profilsensorinformationen geschrie-
ben werden.
Parameter 3
int: die Länge des Puffers. Der Programmierer sollte darauf achten, dass die Länge
des Puffers größer ist als die Länge der ausgegebenen Sensorinformationen. Mit der
Headerdefinition ETHERNETSCANNER_GETINFOSIZEMAX aus "EthernetScannerSDK-
Define.h" kann die Länge des Puffers in Parameter 2definiert werden.
Parameter 4
char*: Legt den Modus der Funktion fest. Die Funktion unterstützt zwei verschiedene Modi:
„Text" und „XML" (siehe Beschreibung unten).
Antwort
ETHERNETSCANNER_INVALIDHANDLE (-1000), wenn das Sensor-Handle (Parameter 1)
NULL oder ungültig ist.
Im Textmodus:
Ist die Größe des Puffers (Parameter 2) kleiner als die Größe der zu schreibenden Daten,
gibt die Funktion ETHERNETSCANNER_GETINFOSMALLERBUFFER (-2) aus. Bei einem
erfolgreichen Vorgang gibt die Funktion die Länge der in den Puffer geschriebenen Daten
aus.
Im XML-Modus:
Ist die Größe des Puffers (Parameter 2) kleiner als die Größe der zu schreibenden Daten,
gibt die Funktion ETHERNET_GETINFOSMALLBUFFER (-2) aus. Bei einem erfolgreichen
Vorgang gibt die Funktion die Länge der in den Puffer geschriebenen Daten aus. Ruft die
Funktion die XML-Daten des Profilsensors nicht ab, gibt sie ETHERNETSCANNER_GET-
INFOINVALIDXML aus (-4).
Beschreibung Im Textmodus:
Gibt Basisinformationen zum Profilsensor als Text aus, z. B. Sensorname, Arbeitsbereiche,
MAC usw. (Beispiel siehe Anlage 1).
Im XML-Modus:
Gibt eine vollständige Beschreibung des Profilsensors im XML-Format aus. Die XML-Datei
enthält allgemeine Informationen über den Profilsensor, die aktuellen Werte aller Merkmale
sowie alle ASCII-Befehle, die der Profilsensor in der Firmware unterstützt (siehe Anhang 2
für ein Beispiel).
126
Software Development Kit (SDK)
Werbung
Inhaltsverzeichnis
