_getdiskfree
ディスク ドライブに関する情報を _diskfree_t 構造体に設定します。
unsigned _getdiskfree(
unsigned drive,
struct _diskfree_t * driveinfo
);
パラメーター
[入力] drive
情報の必要なディスク ドライブ。[出力] driveinfo
ドライブに関する情報が代入される _diskfree_t 構造体。
戻り値
正常終了した場合は、0 を返します。 異常終了した場合は、エラー コードを返します。 errno は、オペレーティング システムが返すエラー値に設定されます。 errno が示すエラー状態の詳細については、「errno 定数」を参照してください。
解説
_diskfree_t 構造体は、Direct.h で定義されています。
struct _diskfree_t {
unsigned total_clusters;
unsigned avail_clusters;
unsigned sectors_per_cluster;
unsigned bytes_per_sector;
};
この関数は、パラメーターを検証します。 driveinfo ポインターが NULL の場合、または drive が無効なドライブを指定している場合、この関数は、「パラメーターの検証」に説明されているように、無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、この関数は EINVAL を返し、errno を EINVAL に設定します。 有効なドライブの範囲は 0 ～ 26 です。 drive 値 0 は現在のドライブを指定し、それ以降の数字は英字にマップされます。たとえば、1 はドライブ A、3 はドライブ C を表します。
total_clusters
ディスク上の使用済みクラスター数と空きクラスター数の合計。avail_clusters
ディスク上の未使用クラスター数。sectors_per_cluster
1 クラスターのセクター数。bytes_per_sector
1 セクターのサイズ (バイト単位)。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_getdiskfree |
<direct.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_getdiskfree.c
// compile with: /c
#include <windows.h>
#include <direct.h>
#include <stdio.h>
#include <tchar.h>
TCHAR g_szBorder[] = _T("======================================================================\n");
TCHAR g_szTitle1[] = _T("|DRIVE|TOTAL CLUSTERS|AVAIL CLUSTERS|SECTORS / CLUSTER|BYTES / SECTOR|\n");
TCHAR g_szTitle2[] = _T("|=====|==============|==============|=================|==============|\n");
TCHAR g_szLine[] = _T("| A: | | | | |\n");
void utoiRightJustified(TCHAR* szLeft, TCHAR* szRight, unsigned uVal);
int main(int argc, char* argv[]) {
TCHAR szMsg[4200];
struct _diskfree_t df = {0};
ULONG uDriveMask = _getdrives();
unsigned uErr, uLen, uDrive;
printf(g_szBorder);
printf(g_szTitle1);
printf(g_szTitle2);
for (uDrive=1; uDrive<=26; ++uDrive) {
if (uDriveMask & 1) {
uErr = _getdiskfree(uDrive, &df);
memcpy(szMsg, g_szLine, sizeof(g_szLine));
szMsg[3] = uDrive + 'A' - 1;
if (uErr == 0) {
utoiRightJustified(szMsg+8, szMsg+19, df.total_clusters);
utoiRightJustified(szMsg+23, szMsg+34, df.avail_clusters);
utoiRightJustified(szMsg+38, szMsg+52, df.sectors_per_cluster);
utoiRightJustified(szMsg+56, szMsg+67, df.bytes_per_sector);
}
else {
uLen = FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM, NULL,
uErr, 0, szMsg+8, 4100, NULL);
szMsg[uLen+6] = ' ';
szMsg[uLen+7] = ' ';
szMsg[uLen+8] = ' ';
}
printf(szMsg);
}
uDriveMask >>= 1;
}
printf(g_szBorder);
}
void utoiRightJustified(TCHAR* szLeft, TCHAR* szRight, unsigned uVal) {
TCHAR* szCur = szRight;
int nComma = 0;
if (uVal) {
while (uVal && (szCur >= szLeft)) {
if (nComma == 3) {
*szCur = ',';
nComma = 0;
}
else {
*szCur = (uVal % 10) | 0x30;
uVal /= 10;
++nComma;
}
--szCur;
}
}
else {
*szCur = '0';
--szCur;
}
if (uVal) {
szCur = szLeft;
while (szCur <= szRight) {
*szCur = '*';
++szCur;
}
}
}
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。