3.20.Api_fct_closefile

Schließt eine Datei. Diese Funktion ist asynchron, siehe API_FCT_OPENFILE.

Die synchrone Version heißt IODrvSynchFileClose.

Prototyp:

typedef int (*PFASYNCHFILECLOSE)(void* pHandle);

Der Rückgabewert ist wie genauso definiert wie bei OPENFILE.

pHandle identifiziert die zu schließende Datei.

3.21.Api_fct_readfile

Ließt aus einer Datei. Diese Funktion ist asynchron, siehe API_FCT_OPENFILE.

Die synchrone Version heißt IODrvSynchFileRead.

Prototyp:

typedef int (*PFASYNCHFILEREAD)(void* pHandle, char* pBuffer, unsigned long ulSize);

pHandle identifiziert die Datei, aus der gelesen werden soll.

pBuffer ist ein Zeiger auf den Datenpuffer, in den die Funktion schreibt.

ulSize gibt die Anzahl Bytes an, die von der Funktion aus der Datei nach pBuffer gelesen werden.

3.22.Api_fct_writefile

Schreibt in eine Datei. Diese Funktion ist asynchron, siehe API_FCT_OPENFILE.

Die synchrone Version heißt IODrvSynchFileWrite.

Prototyp:

typedef int (*PFASYNCHFILEWRITE)(void* pHandle, char* pBuffer, unsigned long ulSize);

pHandle identifiziert die Datei, aus der gelesen werden soll.

pBuffer ist ein Zeiger auf den Datenpuffer, aus dem die Funktion ließt.

ulSize gibt die Anzahl Bytes an, die von der Funktion aus dem Puffer gelesen und in die Datei geschrieben werden.

3.23.Api_fct_prgreset

Ein RESET kann auf der Steuerung ausgeführt werden, je nach vorgegebenem Resetmode.

Prototyp:

typedef void (*PFRTSPROGRAMRESET)(unsigned char byResetMode);

Diese Funktion darf nur ausgeführt werden, wenn der IRQL von NT <= DISPATCH_LEVEL, also ausschließlich im Kontext eines DeviceIOControl-Aufrufs an den IOTreiber oder beim Starten/Beenden des IOTreibers.

3.24.Api_fct_datamanipulation

Diese Funktion kann benutzt werden, um z.B. dem Kernel mitzuteilen, daß er die Retainvariablen löschen soll, oder seinen InitCode auszuführen. Die Art der Manipulation, die durchzuführen ist, muß vom IOTreiber in ulMode übergeben werden, passend dazu eine Zusatzinformation in ulPar.

Prototyp:

typedef unsigned long (*PFDATAMANIPULATION)(unsigned long ulMode, unsigned long ulPar);

Die Funktion sollte nur auf Anfrage benutzt werden. Der derzeitige Kernel unterstützt nur den Aufruf, macht aber noch nichts.

3.25.Api_fct_getprojectinfo

Die Function liefert einen Pointer auf die ProjektInfo-Struktur (siehe IODrvInterface.h) der PLC.

Prototyp:

typedef ProjectInfo* (*PFRTSGETPROJECTINFO)(void);

4.Anhang

Alle Definitionen im Überblick (aus: IodrvInterface.h):

3S – Smart Software Solutions

Seite 17 von 17