FC_GetFreeDiskSpace: ottenere lo spazio di memoria libero

Descrizione della funzione

Questa funzione recupera la quantità di spazio di memoria libero di un supporto di memoria (disco flash, disco RAM, scheda SD) in byte. Il nome del supporto di memoria è trasferito:

oDisco Flash = "ide0:"

oDisco RAM = ram0:"

oSD card = "sd0:"

Impossibile accedere allo spazio di memoria libero di un dispositivo remoto. Se un dispositivo remoto è specificato come parametro, la funzione restituisce "-1".

Rappresentazione grafica

Rappresentazione IL e ST

Per la rappresentazione generale in linguaggio IL o ST, fare riferimento al capitolo Rappresentazione di funzioni e blocchi funzione.

Descrizione delle variabili di I/O

Questa tabella descrive le variabili di ingresso:

L'ingresso	Tipo di dati	Descrizione
i_sVolumeName	STRING[80]	Nome del dispositivo al cui spazio di memoria libero si deve accedere
iq_uliFreeDiskSpace	ULINT	Spazio di memoria libero in byte

Questa tabella descrive le variabili di uscita:

Uscita	Tipo di dati	Descrizione
FC_GetFreeDiskSpace	DINT	0: quantità di spazio di memoria libero recuperato -1: errore durante il tentativo di accedere alla quantità di memoria libera. Ad esempio, è stato selezionato un dispositivo non valido o remoto -318: parametro non valido (i_sVolumeName)

Uscita

Tipo di dati

Descrizione

FC_GetFreeDiskSpace

DINT

0: quantità di spazio di memoria libero recuperato

-1: errore durante il tentativo di accedere alla quantità di memoria libera. Ad esempio, è stato selezionato un dispositivo non valido o remoto

-318: parametro non valido (i_sVolumeName)