FILE_FS_CONTROL_INFORMATION結構（ntifs.h）

發行項
12/21/2024

FILE_FS_CONTROL_INFORMATION 結構可用來查詢或設定目錄中檔案的控制資訊。

語法

typedef struct _FILE_FS_CONTROL_INFORMATION {
  LARGE_INTEGER FreeSpaceStartFiltering;
  LARGE_INTEGER FreeSpaceThreshold;
  LARGE_INTEGER FreeSpaceStopFiltering;
  LARGE_INTEGER DefaultQuotaThreshold;
  LARGE_INTEGER DefaultQuotaLimit;
  ULONG         FileSystemControlFlags;
} FILE_FS_CONTROL_INFORMATION, *PFILE_FS_CONTROL_INFORMATION;

成員

FreeSpaceStartFiltering

內容索引精靈開始文件篩選所需的可用磁碟空間數量下限，以位元組為單位。

FreeSpaceThreshold

索引服務繼續篩選檔和合併字組清單所需的可用磁碟空間數量下限，以位元組為單位。如果可用磁碟空間量低於此閾值，則會將警告訊息寫入 Windows 應用程式事件記錄檔Microsoft。篩選和合併會停止，直到釋放空間為止。

FreeSpaceStopFiltering

內容索引精靈繼續文件篩選所需的可用磁碟空間數量下限，以位元組為單位。如果可用磁碟空間量低於此閾值，則會停止文件篩選。

DefaultQuotaThreshold

磁碟區的預設每個使用者磁碟配額警告閾值。

DefaultQuotaLimit

磁碟區的預設每個使用者磁碟配額限制。

FileSystemControlFlags

旗標的位掩碼，可控制磁碟區上使用者相關配額事件的配額強制執行和記錄。記錄會在 Windows 應用程式事件記錄檔中建立專案。下列一或多個相容的組合：

檔系統控制旗標	意義
FILE_VC_CONTENT_INDEX_DISABLED	如果設定，則會停用內容索引編製。
FILE_VC_LOG_QUOTA_LIMIT	如果設定，當用戶超過指派的磁碟配額限制時，就會建立事件記錄檔專案。
FILE_VC_LOG_QUOTA_THRESHOLD	如果設定，當用戶超過指派的配額警告閾值時，就會建立事件記錄檔專案。
FILE_VC_LOG_VOLUME_LIMIT	如果設定，將會在超過磁碟區的可用空間限制時建立事件記錄檔專案。
FILE_VC_LOG_VOLUME_THRESHOLD	如果設定，將會在超過磁碟區的可用空間閾值時建立事件記錄檔專案。
FILE_VC_QUOTA_ENFORCE	如果設定，則會在磁碟區上強制執行配額。
FILE_VC_QUOTA_TRACK	如果已設定，則會追蹤磁碟區上的配額。
FILE_VC_QUOTAS_INCOMPLETE	如果設定，磁碟區的配額資訊不完整。
FILE_VC_QUOTAS_REBUILDING	如果設定，文件系統會重建磁碟區的配額資訊。

此外，也會定義下列旗標遮罩。這些適用於測試旗標值。

面具	價值
FILE_VC_QUOTA_MASK	FILE_VC_QUOTA_ENFORCE \|FILE_VC_QUOTA_TRACK
FILE_VC_QUOTA_NONE	~FILE_VC_QUOTA_ENFORCE & ~FILE_VC_QUOTA_TRACK
FILE_VC_VALID_MASK	上述表格中所有旗標的 ORed 組合。

言論

這項資訊可透過下列其中一種方式進行查詢：

呼叫 FltQueryVolumeInformation 或 ZwQueryVolumeInformationFile，傳遞 FileFsControlInformation 作為 fileInformation Class 的值，並傳遞呼叫端配置的、FILE_FS_CONTROL_INFORMATION結構化緩衝區作為 fileInformation的值。
使用主要函式程式碼IRP_MJ_QUERY_VOLUME_INFORMATION建立 IRP。

FILE_READ_DATA需要存取磁碟區才能查詢這項資訊。

這項資訊可以透過下列其中一種方式來設定：

呼叫 FltSetVolumeInformation 或 ZwSetVolumeInformationFile，傳遞 FileFsControlInformation 做為 fileInformation Class 的值，並傳遞呼叫端配置的、FILE_FS_CONTROL_INFORMATION結構化緩衝區作為 fileInformation 的值。
使用主要函式程式碼建立 IRP IRP_MJ_SET_VOLUME_INFORMATION。

FILE_WRITE_DATA需要存取磁碟區才能設定這項資訊。

FileInformation 參數中傳遞至 FltQueryVolumeInformation的緩衝區大小，FltSetVolumeInformation， ZwQueryVolumeInformationFile，或 ZwSetVolumeInformationFile 至少必須 sizeof （FILE_FS_CONTROL_INFORMATION）。

此結構必須對齊 LONGLONG （8 位元組）界限。