struktur QUERY_FILE_LAYOUT_OUTPUT (ntifs.h)

Artikel
02/29/2024

Struktur QUERY_FILE_LAYOUT_OUTPUT berfungsi sebagai header untuk entri tata letak file yang dikembalikan dari permintaan FSCTL_QUERY_FILE_LAYOUT .

Sintaks

typedef struct _QUERY_FILE_LAYOUT_OUTPUT {
  ULONG FileEntryCount;
  ULONG FirstFileOffset;
  ULONG Flags;
  ULONG Reserved;
} QUERY_FILE_LAYOUT_OUTPUT, *PQUERY_FILE_LAYOUT_OUTPUT;

Anggota

FileEntryCount

Jumlah entri file yang mengikuti struktur ini.

FirstFileOffset

Offset dalam buffer pengguna untuk entri file pertama.

Flags

Menunjukkan format entri tata letak yang dikembalikan. Bisa 0 atau berikut ini:

Nilai	Makna
QUERY_FILE_LAYOUT_SINGLE_INSTANCED	Instans tunggal entri aliran dan tata letak file dikembalikan. Saat diatur, hanya satu struktur STREAM_LAYOUT_ENTRY yang dikembalikan per aliran dan hanya satu struktur FILE_LAYOUT_ENTRY yang dikembalikan per file. Bendera ini selalu diatur untuk NTFS.

Reserved

Dicadangkan.

Keterangan

Entri tata letak file yang mengikuti struktur QUERY_FILE_LAYOUT_OUTPUT ditentukan oleh bendera yang diatur dalam anggota BenderaQUERY_FILE_LAYOUT_INPUT disediakan sebagai input ke permintaan FSCTL_QUERY_FILE_LAYOUT . Sejumlah struktur FILE_LAYOUT_ENTRY mengikuti QUERY_FILE_LAYOUT_OUTPUT. Bergantung pada entri yang dipilih untuk dikembalikan dari kueri, offset di FILE_LAYOUT_ENTRY menunjukkan di mana entri informasi tambahan berada di buffer pengguna.

Struktur entri berikut dikembalikan ketika bendera inklusi yang sesuai diatur dalam anggota BenderaQUERY_FILE_LAYOUT_INPUT.

Entri	Bendera inklusi
FILE_LAYOUT_NAME_ENTRY	QUERY_FILE_LAYOUT_INCLUDE_NAMES
FILE_LAYOUT_INFO_ENTRY	QUERY_FILE_LAYOUT_INCLUDE_EXTRA_INFO
STREAM_LAYOUT_ENTRY	QUERY_FILE_LAYOUT_INCLUDE_STREAMS
STREAM_EXTENT_ENTRY	QUERY_FILE_LAYOUT_INCLUDE_EXTENTS

Ketika beberapa entri dengan jenis yang sama ada untuk struktur FILE_LAYOUT_ENTRY tunggal, setiap struktur entri informasi memiliki anggota offset yang menunjukkan lokasi entri berikutnya. Rantai struktur entri berlanjut sampai nilai anggota offset adalah 0.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia mulai dari Windows 8.
Header	ntifs.h (termasuk Ntifs.h)

Lihat juga

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT

Bagikan melalui