FILE_ALLOCATION_INFORMATION-Struktur (ntifs.h)

Die FILE_ALLOCATION_INFORMATION-Struktur wird verwendet, um die Zuordnungsgröße für eine Datei festzulegen.

Syntax

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

Member

AllocationSize

Dateizuordnungsgröße in Bytes. In der Regel ist dieser Wert ein Vielfaches der Sektor- oder Clustergröße des zugrunde liegenden physischen Geräts.

Hinweise

Dieser Vorgang kann auf eine der folgenden Arten ausgeführt werden:

  • Rufen Sie FltSetInformationFile oder ZwSetInformationFile auf, übergeben Sie FileAllocationInformation als Wert von FileInformationClass und übergeben einen aufruferseitig zugeordneten, FILE_ALLOCATION_INFORMATION strukturierten Puffer als Wert von FileInformation. Der FileHandle-Parameter gibt die Datei an, deren Zuordnungsgröße festgelegt werden soll.

  • Erstellen Sie eine IRP mit hauptfunktionscode IRP_MJ_SET_INFORMATION.

Dieser Vorgang ist nur für Dateien gültig. Für Verzeichnisse ist sie nicht definiert.

Dateisystemminifilter müssen FltSetInformationFile und nicht ZwSetInformationFile verwenden, um die Zuordnungsgröße für eine Datei festzulegen.

FILE_WRITE_DATA Zugriff ist erforderlich, um diese Informationen festzulegen.

Die Zuordnungsgröße einer Datei und die Position des Dateiendes sind unabhängig voneinander, mit der folgenden Ausnahme: Die Position am Ende der Datei muss immer kleiner oder gleich der Zuordnungsgröße sein. Wenn die Zuordnungsgröße auf einen Wert festgelegt ist, der kleiner als die Position am Ende der Datei ist, wird die Position am Ende der Datei automatisch an die Zuordnungsgröße angepasst.

Die Größe des FileInformation-Puffers, der an FltSetInformationFile oder ZwSetInformationFile übergeben wird, muss = sizeof(FILE_ALLOCATION_INFORMATION)sein>.

Diese Struktur muss an einer LONGLONG-Grenze (8 Byte) ausgerichtet werden.

Anforderungen

Anforderung Wert
Header ntifs.h (include Ntifs.h, Fltkernel.h)

Weitere Informationen

FILE_END_OF_FILE_INFORMATION

FltSetInformationFile

IRP_MJ_SET_INFORMATION

ZwSetInformationFile