Inhaltsverzeichnis
Werbung
10.4.9 Eigenschaftswerte auslesen
Befehl
int EthernetScanner_ReadData(void *pEthernetScanner, char *chPropertyName, char
*chRetBuf, int iRetBuf, int iCacheTime)
Parameter 1
void*: das Handle zum Profilsensor, das von der Funktion „EthernetScanner_Connect"
ausgegeben wird
Parameter 2
char*: Puffer mit dem ASCII-Befehl (abgeschlossen mit Nullzeichen "\0").
Parameter 3
char*: Ausgabepuffer für das Ergebnis des ASCII-Befehls
Parameter 4
int: die Länge des Ausgabepuffers. Mit der Headerdefinition ETHERNETSCANNER_BUF-
FERSIZEMAX aus „EthernetScannerSDKDefine.h" kann die Länge des Puffers in Parame-
ter 3 definiert werden.
Parameter 5
int: die Cache-Zeit in ms; der Wert in diesem Parameter definiert den Funktionsmodus
(XML-Modus oder Scan-Modus). Details siehe nachstehende Beschreibung.
Antwort
Die Funktion gibt Folgendes aus
• ETHERNETSCANNER_READDATAOK (0) bei erfolgreichem Betrieb,
• ETHERNETSCANNER_READDATASMALLBUFFER (-1), wenn der in Parameter 3
übergebene Ausgabepuffer kürzer ist als die Länge der in den Puffer zu schreibenden
Daten,
• ETHERNETSCANNER_READDATANOTSUPPORTEDMODE (-2), wenn der jeweilige
ASCII Befehl im aktuellen Lesemodus nicht unterstützt wird (wie PictureCounter im
XML-Modus),
• ETHERNETSCANNER_READDATAFEATURENOTDEFINED (-3), wenn der ASCII
Befehl nicht unterstützt wird,
• ETHERNETSCANNER_READDATANOSCAN (-4), wenn die Funktion im
Scanmodus aufgerufen wird und noch kein Profil mit der Funktion „EthernetScanner_
GetXZIExtended" abgefragt wird,
• ETHERNETSCANNER_READDATAFAILED (-5), wenn die Funktion die Daten aus XML-
Daten oder Profil nicht lesen konnte.
• ETHERNETSCANNER_INVALIDHANDLE (-1000), wenn das Sensor-Handle (Parameter
1) NULL oder ungültig ist.
2D-/3D-Profilsensoren
101
Werbung
Inhaltsverzeichnis
