Creazione di una nuova flash nel dispositivo specificato.
Sintassi |
flashDiskCreate(string flash, uint flags, uint @size, uint @nackx, uint gid=0): bool |
|---|---|
flash |
Nome del della flash da creare |
flags |
Impostazioni di creazione |
size |
Riferimento a dimensione richiesta della partizione [kb] |
nackx |
Riferimento ad eventuale codice NACK esteso, in caso di errore |
gid |
Identificativo dell'eventuale elemento di percentuale grafico da utilizzare, creabile con la funzione addGauge() |
Esito |
Ritorna esito logico operazione |
Le impostazioni (flags) valide per la funzione sono le seguenti:
Flag |
Descrizione |
|---|---|
flashDiskCreate_QueryOnly |
Interroga solo la dimensione reale che verrebbe applicata alla flash, in base alla richiesta |
flashDiskCreate_Overwrite |
Permette la sovra-scrittura della flash eventualmente esistente |
Annotazioni:
•La creazione è supportata solo per flash di tipo compact.
•Il nome della flash contiene anche il come del dispositivo di riferimento: ad esempio /DISKA1, indica dispositivo A (primario) e flash 1. Per ulteriori informazioni fare comunque riferimento alla documentazione dello specifico dispositivo interessato.
•Specificando il flag flashDiskCreate_Overwrite si ha la possibilità di ricreare la flash eventualmente esistente: in questo caso, occorre fare attenzione in quanto tutto il contenuto della flash verrà irrimediabilmente perso.
•In caso di esito positivo, il riferimento alla dimensione richiesta (size) conterrà invece la dimensione effettivamente applicata (o applicabile se specificato flag flashDiskCreate_QueryOnly).
•Il codice NACK esteso contiene in loWord(nackx) il codice NACK effettivo, mentre in hiWord(nackx) l'eventuale informazione aggiuntiva.
Esempio d'utilizzo
Per creare la flash come prima partizione del dispositivo principale (DISKA1):
uint nackx uint size uint gid = addGauge() size = 1024 ; 1Mb if (flashDiskCreate("/diska1", flashDiskCreate_Overwrite, @size, @nackx, gid)) ; TODO: creazione flash ok else printNack (nackx) ; TODO: gestione errore end |
