FC_GetTotalDiskSpace

FC_GetTotalDiskSpace - Allgemeine Informationen

Übersicht

Typ	Funktion
Verfügbar ab	SystemInterface_1.34.1.0
Verwendet von:	-
Versionen:	Aktuelle Version

Aufgabe

Größe eines Speichermediums auslesen.

Beschreibung

Diese Funktion liest die Größe eines Speichermediums (Flash-Disk, RAM-Disk, USB-Gerät) in Byte aus.

Der Name des Speichermediums wird übertragen:

oFlash-Disk = "ide0:"

oRAM-Disk = "ram0:"

oUSB-Gerät = "usb2msd:0" (ohne Partitionstabelle) oder "usb2msd:1" (mit Partitionstabelle)

Die Größe eines Remote-Geräts kann nicht gelesen werden. Wird ein dezentrales Gerät als Parameter angegeben, liefert die Funktion „-1“ zurück.

Schnittstelle

Eingang	Datentyp	Beschreibung
i_sVolumeName	STRING[80]	Name des Geräts, dessen Speichergröße ausgelesen werden muss

Ein-/Ausgang	Datentyp	Beschreibung
iq_uliTotalDiskSpace	ULINT	Größe des Speichermediums in Byte

Rückgabewert

Datentyp	Beschreibung
DINT	0: Größe erfolgreich ausgelesen. -1: Fehler beim Auslesen der Größe. -318: Mindestens einer der Parameter ist ungültig.

Beispiel

Anforderung

Die Größe der Flash-Disk in der Steuerung soll in Megabyte ermittelt werden.

Deklaration

PROGRAM RamDiskSize
VAR
   uliTotalDiskSpace : ULINT := 0;
   diStatus : DINT := 0;
   diBytesOfMegaByte : DINT := 1048576; // = 1024 * 1024
   diSizeOfRamdiskInMB : LINT := 0;
END_VAR

Programm

diStatus := FC_GetTotalDiskSpace ( 'ide0:', uliTotalDiskSpace );
IF (diStatus = 0) THEN
diSizeOfRamdiskInMB := ULINT_TO_LINT(uliTotalDiskSpace) / diBytesOfMegaByte;
END_IF

Ergebnis

diSizeOfRamdiskInMB enthält die Größe der Flash-Disk in Megabyte.