#include "df_defines.h"

Funktionen
int DF_API_CALL	DFCSystemReadRecord (int connectionNumber, int deviceAddress, unsigned char buffer, int bufferSize, int *errorNumber)
	Logdatensatz aus Gerät lesen.

int DF_API_CALL	DFCSystemQuitRecord (int connectionNumber, int deviceAddress, int *errorNumber)
	Logdatensatz im Gerät quittieren.

int DF_API_CALL	DFCSystemRestoreRecords (int connectionNumber, int deviceAddress, int *errorNumber)
	Logdatensätze wiederherstellen.

Dokumentation der Funktionen

◆ DFCSystemQuitRecord()

int DF_API_CALL DFCSystemQuitRecord	(	int	connectionNumber,
		int	deviceAddress,
		int *	errorNumber
	)

Logdatensatz im Gerät quittieren.

Es wird versucht, einen zuvor mit DFCSystemReadRecord() gelesenen Logatensatz zu quittieren. Nach erfolgreicher Quittierung kann mit einem folgenden Aufruf von DFCSystemReadRecord() der ggf. nächste Datensatz gelesen werden.

Export: DFComDLL als _DFCSystemQuitRecord@12
DFCom_x64 als DFCSystemQuitRecord

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

-1	Fehler bei Ausführung.
0	Keine Quittung benötigt.
1	Datensatz quittiert.

Seit: 04.01.07 enthalten

◆ DFCSystemReadRecord()

int DF_API_CALL DFCSystemReadRecord	(	int	connectionNumber,
		int	deviceAddress,
		unsigned char *	buffer,
		int *	bufferSize,
		int *	errorNumber
	)

Logdatensatz aus Gerät lesen.

Es wird versucht, einen Logdatensatz aus dem Gerät zu lesen. Nach erfolgreicher Vararbeitung muss dieser mit DFCSystemQuitRecord() quittiert werden, damit weitere Datensätze abgerufen werden können. Wird ein Datensatz nicht mit DFCSystemQuitRecord() quittiert wird er als ein Wiederholt gelieferter Datensatz gemeldet.

Export: DFComDLL als _DFCSystemReadRecord@20
DFCom_x64 als DFCSystemReadRecord

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[out]	buffer	Datenpuffer.
[in,out]	bufferSize	Als `in` die reservierte Größe von buffer (mindestens 512 Byte), als `out` die übergebene Datensatzlänge.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

-1	Fehler bei Ausführung.
0	Keine Datensätze vorhanden.
1	Datensatz gelesen.

Seit: 04.01.07 enthalten

◆ DFCSystemRestoreRecords()

int DF_API_CALL DFCSystemRestoreRecords	(	int	connectionNumber,
		int	deviceAddress,
		int *	errorNumber
	)

Logdatensätze wiederherstellen.

Durch ein Zurücksetzen der Datensatzzeiger auf den letzten auslesbaren Logdatensatz wird ein Wiederauslesen über DFCSystemReadRecord() möglich. Durch Verwendung eines Ringspeichers in den Geräten werden ggf. ältere Datensätze durch aktuellere überschrieben.

Export: DFComDLL als _DFCSystemRestoreRecords@12
DFCom_x64 als DFCSystemRestoreRecords

Warnung: Durch ein Wiederherstellen der Datensätze kann eine ggf. sehr große Datensatzmenge entstehen.

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[out]	errorNumber	Fehlernummer bei fehlerhafter Ausführung.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit: 04.01.07 enthalten