windows API之GetDiskFreeSpaceEx

检测磁盘空间大小的API，原型：

GetDiskFreeSpaceExW(
    _In_opt_ LPCWSTR lpDirectoryName,//磁盘名称
    _Out_opt_ PULARGE_INTEGER lpFreeBytesAvailableToCaller,//可用空间
    _Out_opt_ PULARGE_INTEGER lpTotalNumberOfBytes,//总空间
    _Out_opt_ PULARGE_INTEGER lpTotalNumberOfFreeBytes//剩余空间
    );

LARGE_INTEGER是一个结构体，有32位的高字节和32位的低字节，结构如下：

typedef union _ULARGE_INTEGER {
struct {
    DWORD LowPart;
    DWORD HighPart;
  };
  struct {
    DWORD LowPart;
    DWORD HighPart;
  } u;
  ULONGLONG QuadPart;
} ULARGE_INTEGER, *PULARGE_INTEGER;

参数以字节返回，换算为GB单位时可用

#define GB(x) (((x).HighPart << 2) + ((float)(x).LowPart) / 1024.0 / 1024.0 / 1024.0)

宏定义解析：
2 10=1KB
2 20=1MB
2 30=1GB
ULARGE_INTEGER的高位是从第33位往上，而30位以上的都是GB，则高位的所有数据都是GB级别。
低位32位，最高的两位也是GB级别，为了数据的准确性，把这两位低位的数据加到高位上
则将高位左移两位，空出两个bit位正好低位的两个最高bit位填补。

剩下0位/1024/1024/1024可算出其余空间与高位相加，算出总空间。

使用范例：

1、轮询检测电脑各个磁盘

void CheckDeskInfo()
{
	TCHAR buf[MAX_PATH] = {};
	GetLogicalDriveStrings(MAX_PATH, buf);
	TCHAR*  pDrives = buf;
	while (*pDrives != 0) {
		if (GetDiskFreeSpaceEx(pDrives, &nFreeBytesAvailable, &nTotalNumberOfBytes, &nTotalNumberOfFreeBytes))
		{
			TCHAR chBuf[256];
			wsprintf(chBuf, _T("%I64d,总共%I64dG,剩余%I64dG/r/n"),
				(nFreeBytesAvailable.QuadPart) / 1024 / 1024 / 1024, (nTotalNumberOfBytes.QuadPart) / 1024 / 1024 / 1024, (nTotalNumberOfFreeBytes.QuadPart) / 1024 / 1024 / 1024);
			OutputDebugString(chBuf);
		}
		pDrives += wcslen(pDrives) + 1;
	}
}

2、返回/提取具体数值

接受数据的类型无法解析转换为普通数据类型，所以使用unsigned _int64这种方法，不会使数据丢失，我只使用free数据，所以只转换一个

int GetDeskFreeInfo()
{
	unsigned _int64 nFreeBytesAvailable;
	ULARGE_INTEGER nTotalNumberOfBytes;
	uLARGE_INTEGER nTotalNumberOfFreeBytes;
	int freespace = -1;
	if (false == ::GetDiskFreeSpaceEx(L"C:", (ULARGE_INTEGER *)&nFreeBytesAvailable, &nTotalNumberOfBytes, &nTotalNumberOfFreeBytes))
	{
		DWORD dError = ::GetLastError();
		ZPPFileMgrHelper::postLog(pInstance, DOWNLOADMGR_LOG_LEVEL_LOG,
		ZFunctions::PrintString("ZFileCacheManager::CheckDiskSpace error params: %s", params.c_str()));
		freespace = -1;
	}
	freespace = nFreeBytesAvailable / 1024 / 1024;
	return freespace;
}