Deklarationen der Funktionen für die Arbeit mit den Setuplisten.
Mehr ...
gehe zum Quellcode dieser Datei
|
DF_API_EXTERN int DF_API_CALL | DFCMakeListe (int connectionId, int number, int recordCount, int size, unsigned char *buffer, int unused_setTo0) |
| Setzen des Listenbuffers fuer eine Liste. Mehr ...
|
|
DF_API_EXTERN int DF_API_CALL | DFCLoadListen (int connectionId, int deviceAddress, int *errorNumber) |
| Uebertragen der Listendaten zum Geraet. Mehr ...
|
|
DF_API_EXTERN void DF_API_CALL | DFCClrListenBuffer (int connectionId) |
| Buffer fuer Listendaten loeschen. Mehr ...
|
|
DF_API_EXTERN int DF_API_CALL | DFCLoadListenbeschreibung (int connectionId, int deviceAddress, int *errorNumber) |
| Tabellenbeschreibungen fuer Listen aus Geraet lesen. Mehr ...
|
|
DF_API_EXTERN int DF_API_CALL | DFCListBCnt (int connectionId) |
| Anzahl der Tabellenbeschreibungen fuer Listen ermitteln. Mehr ...
|
|
DF_API_EXTERN int DF_API_CALL | DFCListBDatensatz (int connectionId, int number, unsigned char *name, int *fieldCount, int *unused_setTo0) |
| Grunddaten einer Tabellenbeschreibungen fuer Listen ermitteln. Mehr ...
|
|
DF_API_EXTERN int DF_API_CALL | DFCListBFeld (int connectionId, int listBNumber, int number, unsigned char *name, int *type, int *size) |
| Grunddaten eines Tabellenfeldes fuer Listen ermitteln. Mehr ...
|
|
Deklarationen der Funktionen für die Arbeit mit den Setuplisten.
- Autor
- Bernd Ottmann
- Datum
- 21.02.2003
DF_API_EXTERN void DF_API_CALL DFCClrListenBuffer |
( |
int |
connectionId | ) |
|
Buffer fuer Listendaten loeschen.
Loescht in der DLL den Buffer fuer Listendaten. Die zuvor schon importierten Listen waehren nach Ausfuehrung wiederholt zu importieren.
- Parameter
-
connectionId | Kommunikationskanalnummer. |
- Rückgabe
- Keine.
DF_API_EXTERN int DF_API_CALL DFCListBCnt |
( |
int |
connectionId | ) |
|
Anzahl der Tabellenbeschreibungen fuer Listen ermitteln.
Auf Grundlage der zuvor mit DFCLoadListenbeschreibung() gelesenen Daten, wird die Anzahl der definierten Tabellen zurueckgegeben.
- Parameter
-
connectionId | Kommunikationskanalnummer. |
- Rückgabe
- Anzahl der mit DFCLoadListenbeschreibung() gelesenen Tabellendefinitionen.
- Version
- Ab DLL - Version 1.1.i enthalten.
DF_API_EXTERN int DF_API_CALL DFCListBDatensatz |
( |
int |
connectionId, |
|
|
int |
number, |
|
|
unsigned char * |
name, |
|
|
int * |
fieldCount, |
|
|
int * |
unused_setTo0 |
|
) |
| |
Grunddaten einer Tabellenbeschreibungen fuer Listen ermitteln.
Auf Grundlage der zuvor mit DFCLoadListenbeschreibung() gelesenen Daten, werden die Grunddaten zu einer Tabellen zurueckgegeben.
- Parameter
-
connectionId | Kommunikationskanalnummer. |
number | Tabellennummer im Bereich von (0 - (DFCListBCnt() - 1)). |
name | Zeiger auf Speicherbereich fuer Tabellenname. (Mindestens 17 Zeichen). |
fieldCount | Zeiger auf Variable, welche die Feldanzahl der Tabelle erhaelt. |
unused_setTo0 | Zeiger auf Variable, welche immer eine 0 erhaelt. (Kompatible zu Timeboy) |
- Rückgabe
- Ergebnis der Ausfuehrung.
- Rückgabewerte
-
0 | Funktion konnte nicht ausgefuehrt werden. (Tabelle nicht definiert!) |
1 | Funktion wurde erfolgreich ausgefuehrt. |
- Version
- Ab DLL - Version 1.1.i enthalten.
DF_API_EXTERN int DF_API_CALL DFCListBFeld |
( |
int |
connectionId, |
|
|
int |
listBNumber, |
|
|
int |
number, |
|
|
unsigned char * |
name, |
|
|
int * |
type, |
|
|
int * |
size |
|
) |
| |
Grunddaten eines Tabellenfeldes fuer Listen ermitteln.
Auf Grundlage der zuvor mit DFCLoadListenbeschreibung() gelesenen Daten, werden die Grunddaten zu einem Tabellenfeld zurueckgegeben.
- Parameter
-
connectionId | Kommunikationskanalnummer. |
listBNumber | Tabellennummer im Bereich von (0 - (DFCListBCnt() - 1)). |
number | Feldnummer. |
name | Zeiger auf Speicherbereich fuer Feldname. (Mindestens 17 Zeichen). |
type | Zeiger auf Variable, welche den Feldtyp erhaelt. |
size | Zeiger auf Variable, welche die definierte Laenge des Feldes erhaelt, in dieser ist auch das Nullterminierungszeichen enthalten. |
- Rückgabe
- Ergebnis der Ausfuehrung.
- Rückgabewerte
-
0 | Funktion konnte nicht ausgefuehrt werden. (Tabelle nicht definiert!) |
1 | Funktion wurde erfolgreich ausgefuehrt. |
- Version
- Ab DLL - Version 1.1.i enthalten.
DF_API_EXTERN int DF_API_CALL DFCLoadListen |
( |
int |
connectionId, |
|
|
int |
deviceAddress, |
|
|
int * |
errorNumber |
|
) |
| |
Uebertragen der Listendaten zum Geraet.
Es wird versucht, die zuvor mit DFCMakeListe() importierten Listendaten in das Geraet zu uebertragen.
- Parameter
-
connectionId | Kommunikationskanalnummer. |
deviceAddress | Busnummer des anzusprechenden Geraetes. |
errorNumber | Zeiger auf Variable die nach Fehler den Fehlercode erhaelt. |
- Rückgabe
- Ergebnis der Ausfuehrung.
- Rückgabewerte
-
0 | Funktion konnte nicht ausgefuehrt werden. |
1 | Funktion wurde erfolgreich ausgefuehrt. |
DF_API_EXTERN int DF_API_CALL DFCLoadListenbeschreibung |
( |
int |
connectionId, |
|
|
int |
deviceAddress, |
|
|
int * |
errorNumber |
|
) |
| |
Tabellenbeschreibungen fuer Listen aus Geraet lesen.
Es wird versucht die Tabellenbeschreibungen aus dem Geraet zu lesen. Hiernach koennen mit den Funktionen DFCListBCnt(), DFCListBDatensatz() und DFCListBFeld() auf den ermittelten Daten gearbeitet werden.
- Parameter
-
connectionId | Kommunikationskanalnummer. |
deviceAddress | Busnummer des anzusprechenden Geraetes. |
errorNumber | Zeiger auf Variable die nach Fehler den Fehlercode erhaelt. |
- Rückgabe
- Ergebnis der Ausfuehrung.
- Rückgabewerte
-
0 | Funktion konnte nicht ausgefuehrt werden. |
1 | Funktion wurde erfolgreich ausgefuehrt. |
- Version
- Ab DLL - Version 1.1.i enthalten.
DF_API_EXTERN int DF_API_CALL DFCMakeListe |
( |
int |
connectionId, |
|
|
int |
number, |
|
|
int |
recordCount, |
|
|
int |
size, |
|
|
unsigned char * |
buffer, |
|
|
int |
unused_setTo0 |
|
) |
| |
Setzen des Listenbuffers fuer eine Liste.
Die Listen muessen ihrer Reichenfolge nach (0 .. n) in den DLL internen Buffer uebertragen werden.
- Parameter
-
connectionId | Kommunikationskanalnummer. |
number | Tabellennummer. |
recordCount | Anzahl der Zeilen, Datensaetze im Block. |
size | Anzahl Byte im Block. Brechnet sich aus (Anzahl Datensaetzte Datensatzlaenge). |
buffer | Zeiger auf Bytearray, welches die Daten enthaelt. |
unused_setTo0 | Kann immer mit 0 uebergeben werden. (Kompatibel mit Timeboy) |
- Rückgabe
- Ergebnis der Ausfuehrung.
- Rückgabewerte
-
0 | Funktion konnte nicht ausgefuehrt werden. |
1 | Funktion wurde erfolgreich ausgefuehrt. |