FILE_FS_CONTROL_INFORMATION 構造体 (ntifs.h)

[アーティクル]
01/10/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

Content-Indexing デーモンがドキュメントフィルター処理を開始するために必要な空きディスク領域の最小容量 (バイト単位)。

FreeSpaceThreshold

インデックスサービスがドキュメントのフィルター処理と単語リストのマージを続行するために必要な最小空きディスク領域 (バイト単位)。空きディスク領域がこのしきい値を下回ると、警告メッセージが Microsoft Windows アプリケーションイベントログに書き込まれます。フィルター処理とマージは、領域が解放されるまで停止されます。

FreeSpaceStopFiltering

Content-Indexing デーモンがドキュメントフィルター処理を続行するために必要な最小空きディスク領域 (バイト単位)。空きディスク領域がこのしきい値を下回った場合、ドキュメントのフィルター処理は停止されます。

DefaultQuotaThreshold

ボリュームの既定のユーザーごとのディスククォータ警告しきい値。

DefaultQuotaLimit

ボリュームの既定のユーザーごとのディスククォータ制限。

FileSystemControlFlags

ボリュームでのユーザー関連のクォータイベントのクォータの適用とログ記録を制御するフラグのビットマスク。ログは、Windows アプリケーションイベントログにエントリを作成します。以下の 1 つ以上の互換性のある組み合わせ:

ファイルシステム制御フラグ	意味
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 を FileInformationClass の値として渡し、呼び出し元によって割り当てられたFILE_FS_CONTROL_INFORMATION構造化バッファーを FileInformation の値として渡します。
主要な関数コードIRP_MJ_QUERY_VOLUME_INFORMATIONを使用して IRP を作成します。

この情報FILE_READ_DATAクエリを実行するには、ボリュームへのアクセスが必要です。

この情報は、次のいずれかの方法で設定できます。

FltSetVolumeInformation または ZwSetVolumeInformationFile を呼び出し、FileFsControlInformation を FileInformationClass の値として渡し、呼び出し元によって割り当てられたFILE_FS_CONTROL_INFORMATION構造化バッファーを FileInformation の値として渡します。
主要な関数コードIRP_MJ_SET_VOLUME_INFORMATIONを使用して IRP を作成します。

この情報FILE_WRITE_DATA設定するには、ボリュームへのアクセスが必要です。

FileInformation パラメーターで FltQueryVolumeInformation、FltSetVolumeInformation、ZwQueryVolumeInformationFile、または ZwSetVolumeInformationFile に渡されるバッファーのサイズは、少なくとも sizeof (FILE_FS_CONTROL_INFORMATION) である必要があります。

この構造体は、LONGLONG (8 バイト) 境界に配置する必要があります。