FILE_ALLOCATION_INFORMATION結構 (ntifs.h)

FILE_ALLOCATION_INFORMATION 結構是用來設定檔案的配置大小。

語法

typedef struct _FILE_ALLOCATION_INFORMATION {
  LARGE_INTEGER AllocationSize;
} FILE_ALLOCATION_INFORMATION, *PFILE_ALLOCATION_INFORMATION;

AllocationSize

檔案配置大小，以位元組為單位。此值通常是基礎實體裝置的扇區或叢集大小的倍數。

此作業可以透過下列任一方式執行：

呼叫 FltSetInformationFile 或 ZwSetInformationFile，將 FileAllocationInformation 傳遞為 FileInformationClass 的值，並傳遞呼叫端配置的已配置、FILE_ALLOCATION_INFORMATION結構化緩衝區作為 FileInformation 的值。 FileHandle 參數會指定要設定其配置大小的檔案。
使用主要函式程式碼建立 IRP IRP_MJ_SET_INFORMATION。

這項作業只適用於檔案。目錄未定義。

文件系統迷你篩選必須使用 FltSetInformationFile，而非 ZwSetInformationFile 來設定檔案的配置大小。

需要FILE_WRITE_DATA存取權才能設定這項資訊。

檔案的配置大小和檔尾位置彼此獨立，但有下列例外狀況：檔尾位置必須一律小於或等於配置大小。如果配置大小設定為小於檔尾位置的值，則會自動調整檔尾位置以符合配置大小。

傳遞至 FltSetInformationFile 或 ZwSetInformationFile的FileInformation 緩衝區大小必須是 >= sizeof(FILE_ALLOCATION_INFORMATION)。

此結構必須對齊 LONGLONG (8 位元組) 界限。