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_MJ_SET_INFORMATIONを使用して IRP を作成します。

この操作は、ファイルに対してのみ有効です。ディレクトリに対しては未定義です。

ファイルシステムミニフィルターでは、ファイルの割り当てサイズを設定するために、ZwSetInformationFile ではなく FltSetInformationFile を使用する必要があります。

この情報FILE_WRITE_DATA設定するには、アクセス権が必要です。

ファイルの割り当てサイズとファイルの終了位置は相互に独立しています。次の例外があります。ファイルの終わりの位置は、常に割り当てサイズ以下である必要があります。割り当てサイズがファイルの終わり位置より小さい値に設定されている場合、ファイルの終わりの位置は割り当てサイズに合わせて自動的に調整されます。

FltSetInformationFile または ZwSetInformationFile に渡される FileInformation バッファーのサイズは、 = sizeof(FILE_ALLOCATION_INFORMATION)である>必要があります。

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

要件	値
Header	ntifs.h (Ntifs.h、Fltkernel.h を含む)