getdfree

Nach oben zu dos.h - Index

Header-Datei

dos.h

Kategorie

Verzeichnisbearbeitungsroutinen, Verschiedene Routinen

Prototyp

void getdfree(unsigned char drive, struct dfree *dtable);

Beschreibung

Ermittelt den freien Festplattenspeicher.

getdfree übernimmt mit drive einen Laufwerksbezeichner (0 für das aktuelle Laufwerk, 1 für A usw.) und trägt die Datenträgerattribute in die Struktur dfree ein, auf die dtable zeigt.

Die Struktur dfree ist wie folgt definiert:

struct dfree {

unsigned df_avail; /* Verfügbare Cluster */

unsigned df_total; /* Gesamtzahl der Cluster */

unsigned df_bsec; /* Bytes pro Sektor */

unsigned df_sclus; /* Sektoren pro Cluster */

};

Rückgabewert

getdfree gibt keinen Wert zurück. Wenn ein Fehler auftritt, wird df_sclus in der Struktur dfree der Wert (unsigned) -1 zugewiesen.

Beispiel

 #include <stdio.h>
 #include <dos.h>
 #include <process.h>
 int main(void)
 {
   struct dfree free;
   long avail;
   getdfree(0, &free);
   if ( free.df_sclus == -1)
   {
     printf("Error in getdfree() call\n");
     exit(1);
   }
   avail = (long) free.df_avail
         * (long) free.df_bsec
         * (long) free.df_sclus;
   printf("The current drive has %ld bytes available\n", avail);
   return  0;
 }

Portabilität

POSIX	Win32	ANSI C	ANSI C++
	+