FC_GetFreeDiskSpace: Ruft den freien Speicherplatz ab
Beschreibung der Funktion
Diese Funktion ruft den freien Speicherplatz eines Speichermediums (Benutzerdatenträger, Systemdatenträger, SD-Karte) in Byte ab.
Der Name des Speichermediums wird übertragen:
-
Benutzerdatenträger = "/usr"
-
Systemdatenträger = "/sys"
-
SD-Karte = "/sd0"
Auf den freien Speicherplatz eines dezentralen Geräts kann nicht zugegriffen werden. Wird ein dezentrales Gerät als Parameter angegeben, gibt 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) |