_getdiskfree
_diskfree_t の構造に読み込むディスク ドライブに関する情報を使用します。
重要 |
---|
この API は Windows ランタイムで実行されるアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。 |
unsigned _getdiskfree(
unsigned drive,
struct _diskfree_t * driveinfo
);
パラメーター
[入力] drive
は、情報が必要なディスク ドライブ。[出力] driveinfo
ドライブに関する情報が設定された _diskfree_t の構造。
戻り値
関数が正常終了した場合、戻り値はゼロです。関数が失敗した場合、戻り値はエラー コードです。値 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 の範囲です。0 という drive の値は、現在のドライブを指定します; 1 ではドライブを指定できます。その後は、英語のアルファベット文字数へのマップはそのうち 3、15 のドライブ B などが示されています。
total_clusters
ディスクで使用され、使用できるクラスターの合計数。avail_clusters
ディスクの未使用のクラスターの数。sectors_per_cluster
各クラスターのセクターの数。bytes_per_sector
バイトの各セクターのサイズ。
必要条件
ルーチン |
必須ヘッダー |
---|---|
_getdiskfree |
<direct.h> |
互換性の詳細については、互換性を参照してください。
使用例
// 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 を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。