Datafox DFCom - API 04.03.22
Dokumentation zur Datafox Kommunikationsbibliothek (DFComDLL.dll / DFCom_x64.dll)
df_timeboy_lists.h-Dateireferenz
#include "df_defines.h"

gehe zum Quellcode dieser Datei

Funktionen

void DF_API_CALL DFCClearTimeboyListBuffer (int connectionNumber, int groupNumber, int number)
 Bibliotheksinterne Datenpuffer für Timeboylistendaten löschen und initalisieren.
 
int DF_API_CALL DFCMakeTimeboyList (int connectionNumber, int groupNumber, int number, int recordCount, int size, const unsigned char *buffer, int flags, int *errorNumber)
 Kopieren eines aufbereiteten Datenarrays für eine Timeboyliste in den Biblioteksinternen Datenpuffer.
 
int DF_API_CALL DFCLoadTimeboyList (int connectionNumber, int deviceAddress, int groupNumber, int number, int unused_setTo0, int *errorNumber)
 Übertragen der bibliotheksinternen Datenpuffer zum Gerät.
 

Dokumentation der Funktionen

◆ DFCClearTimeboyListBuffer()

void DF_API_CALL DFCClearTimeboyListBuffer ( int  connectionNumber,
int  groupNumber,
int  number 
)

Bibliotheksinterne Datenpuffer für Timeboylistendaten löschen und initalisieren.

Die in der Bibliothek bereitgestellten Datenpuffer für die zu übertragenenden Listendaten werden gelöscht und für eine Verwendung mittels DFCMakeTimeboyList() und DFCLoadTimeboyList() initalisiert.

Export
DFComDLL als _DFCClearTimeboyListBuffer@12
DFCom_x64 als DFCClearTimeboyListBuffer
Parameter
[in]connectionNumberZu verwendende Verbindungsnummer.
[in]groupNumberGruppennummer der Liste. Bereich -1 bist 19. Mit der Angabe von -1 werden alle Gruppen angesprochen.
[in]numberListennummer. Bereich -1 bist 19. Bei einer Angabe von -1 werden alle Datenpuffer gelöscht.
Seit
04.01.04 enthalten

◆ DFCLoadTimeboyList()

int DF_API_CALL DFCLoadTimeboyList ( int  connectionNumber,
int  deviceAddress,
int  groupNumber,
int  number,
int  unused_setTo0,
int *  errorNumber 
)

Übertragen der bibliotheksinternen Datenpuffer zum Gerät.

Es werden die mit DFCMakeTimeboyList() importierten Listendaten in das Gerät geschrieben. Vorhandene Listendaten werden hierbei erst nach einer erfolgreichen Übernahme überschrieben.

Export
DFComDLL als _DFCLoadTimeboyList@24
DFCom_x64 als DFCLoadTimeboyList
Parameter
[in]connectionNumberZu verwendende Verbindungsnummer.
[in]deviceAddressAnzusprechende Geräteadresse.
[in]groupNumberGruppennummer. Eine Angabe von -1 meint alle Gruppen.
[in]numberListennummer. Bei Angabe von -1 werden alle importierten Listen zur angegebenen Gruppe übertragen.
[in]unused_setTo0Reservierter Parameter, aktuell mit 0 übergeben.
[out]errorNumberFehlernummer bei fehlerhafter Ausführung.
Rückgabewerte
0Fehler bei Ausführung.
1Ausführung war erfolgreich.
Seit
04.01.04 enthalten

◆ DFCMakeTimeboyList()

int DF_API_CALL DFCMakeTimeboyList ( int  connectionNumber,
int  groupNumber,
int  number,
int  recordCount,
int  size,
const unsigned char *  buffer,
int  flags,
int *  errorNumber 
)

Kopieren eines aufbereiteten Datenarrays für eine Timeboyliste in den Biblioteksinternen Datenpuffer.

Der zu übergebende Datenpuffer wird in den Bibliotheksinternen Datenpuffer kopiert und für eine spätere Übertragung mittels DFCLoadTimeboyList() zwischengespeichert.

Export
DFComDLL als _DFCMakeTimeboyList@32
DFCom_x64 als DFCMakeTimeboyList
Parameter
[in]connectionNumberZu verwendende Verbindungsnummer.
[in]groupNumberGruppennummer der Liste. Bei Angabe von 0 ist die so übergebene Liste für alle Gruppen gültig.
[in]numberListennummer.
[in]recordCountAnzahl der Datensätze im übergebenen Datenarray.
[in]sizeAnzahl Byte des Datenarrays.
Brechnet sich aus (recordCount * Größe pro Datensatz).
[in]bufferDatenarray mit den Daten.
[in]flagsAngebbare Flags zur Liste. Z.B. Bit 1 ob Liste gelöscht werden soll.
[out]errorNumberFehlernummer bei fehlerhafter Ausführung.
Rückgabewerte
0Fehler bei Ausführung.
1Ausführung war erfolgreich.
Seit
04.01.04 enthalten

© 2003-2024 Datafox GmbH