Cette fonction obtient la quantité d'espace libre d'un support mémoire (disque utilisateur, disque système, carte SD), en octets.
Le nom du support mémoire est transféré :
Disque utilisateur = "/usr"
Disque système = "/sys"
Carte SD = "/sd0"
L’espace mémoire disponible sur un équipement distant n’est pas accessible. Si le paramètre d'entrée désigne un équipement distant, la fonction renvoie la valeur "-1".
Pour voir la représentation générale en langage IL ou ST, consultez le chapitre Représentation des fonctions et blocs fonction.
Le tableau suivant décrit les variables d'entrée :
Entrée |
Type de données |
Description |
---|---|---|
i_sVolumeName |
STRING[80] |
Nom de l'équipement dont l'espace mémoire disponible doit être consulté |
iq_uliFreeDiskSpace |
ULINT |
Espace mémoire libre en octets |
Le tableau suivant décrit les variables de sortie :
Sortie |
Type de données |
Description |
---|---|---|
FC_GetFreeDiskSpace |
DINT |
0 : La quantité d'espace mémoire libre a été obtenue. -1 : Erreur lors de la tentative d'accès à la quantité de mémoire libre. Par exemple, un équipement non valide ou un équipement distant a été sélectionné -318 : Paramètre non valide (i_sVolumeName) |