X-Git-Url: http://cloudbase.mooo.com/gitweb/z180-stamp.git/blobdiff_plain/70702af1370e44e32fb2c3c507e4759a187b4fe5..289f6a146c0b2087607d8d8659531ea90142779a:/fatfs/doc/ja/getfree.html diff --git a/fatfs/doc/ja/getfree.html b/fatfs/doc/ja/getfree.html deleted file mode 100644 index bb2a452..0000000 --- a/fatfs/doc/ja/getfree.html +++ /dev/null @@ -1,95 +0,0 @@ - - - - - - - - -FatFs - f_getfree - - - - -
-

f_getfree

-

ボリューム上の空き領域のサイズを取得します。

-
-FRESULT f_getfree (
-  const TCHAR* path,  /* [IN] 対象ドライブを指定します */
-  DWORD* nclst,       /* [OUT] 空きクラスタ数を格納する変数へのポインタ */
-  FATFS** fatfs       /* [OUT] ファイル システム オブジェクトを指すポインタへのポインタ */
-);
-
-
- -
-

引数

-
-
path
-
調べる対象の論理ドライブを示すパス名を示すヌル文字'\0'終端の文字列へのポインタを指定します。ヌル文字列はカレント ドライブを意味します。
-
nclst
-
空きクラスタ数を格納するDWORD型変数へのポインタを指定します。
-
fatfs
-
対象ドライブのファイル システム オブジェクトを指すポインタが返されます。
-
-
- - -
-

戻り値

-

-FR_OK, -FR_DISK_ERR, -FR_INT_ERR, -FR_NOT_READY, -FR_INVALID_DRIVE, -FR_NOT_ENABLED, -FR_NO_FILESYSTEM, -FR_TIMEOUT -

-
- - -
-

解説

-

論理ドライブ上の空き領域のサイズをクラスタ単位で取得します。返されたファイル システム オブジェクトのcsizeメンバがクラスタあたりのセクタ数を示しているので、これを元にセクタ単位の空きサイズが計算できます。FAT32ボリュームにおいては、FSINFOの情報が実際の空きクラスタ数と同期していない場合、不正確な値を返す可能性があります。この問題を避けるため、_FS_NOFSINFOオプションでマウント後の初回は必ずフルFATスキャンをするように構成することもできます。

-
- - -
-

対応情報

-

_FS_READONLY == 0で、且つ_FS_MINIMIZE == 0のとき使用可能です。

-
- - -
-

使用例

-
-    FATFS *fs;
-    DWORD fre_clust, fre_sect, tot_sect;
-
-
-    /* ドライブ1のボリューム情報と空きクラスタ数を得る */
-    res = f_getfree("1:", &fre_clust, &fs);
-    if (res) die(res);
-
-    /* 全セクタ数と空きセクタ数を計算 */
-    tot_sect = (fs->n_fatent - 2) * fs->csize;
-    fre_sect = fre_clust * fs->csize;
-
-    /* ボリュームのサイズと空きサイズを表示 (512バイト/セクタと仮定) */
-    printf("%10lu KiB total drive space.\n%10lu KiB available.\n",
-           tot_sect / 2, fre_sect / 2);
-
-
- - -
-

参照

-FATFS -
- -

戻る

- -