FC_GetFreeDiskSpace: Abrufen des freien Speicherplatzes
Diese Funktion ruft den freien Speicherplatz eines Speichermediums (Flash-Disk, RAM-Disk, SD-Karte) in Byte ab. Der Name des Speichermediums wird übertragen:
oFlash-Disk = "ide0:"
oRAM-Disk = "ram0:"
oSD-Karte = "sd0:"
Auf den freien Speicherplatz eines dezentralen Geräts kann nicht zugegriffen werden. Wird ein dezentrales Gerät als Parameter angegeben, liefert die Funktion „-1“ zurück.
Darstellung in AWL (IL) und ST
Die allgemeine Darstellung in den Sprachen AWL (IL) oder ST finden Sie im Kapitel Darstellung von Funktionen und Funktionsbausteinen.
Beschreibung der E/A-Variablen
In der folgenden Tabelle werden die Eingangsvariablen beschrieben:
|
Eingang |
Datentyp |
Beschreibung |
|---|---|---|
|
i_sVolumeName |
STRING[80] |
Name des Geräts, auf dessen freien Speicherplatz zugegriffen werden soll |
|
iq_uliFreeDiskSpace |
ULINT |
Freier Speicherplatz in Byte |
In der folgenden Tabelle werden die Ausgangsvariablen beschrieben:
|
Ausgang |
Datentyp |
Beschreibung |
|---|---|---|
|
FC_GetFreeDiskSpace |
DINT |
0: Freier Speicherplatz, der erfolgreich abgerufen wurde -1: Fehler beim Versuch, auf den freien Speicherplatz zuzugreifen Beispielsweise wurde ein ungültiges Gerät oder dezentrales Gerät ausgewählt -318: Ungültiger Parameter (i_sVolumeName). |
