структура QUERY_FILE_LAYOUT_OUTPUT (ntifs.h)

Статья
02/07/2025

Структура QUERY_FILE_LAYOUT_OUTPUT служит заголовком для записей макета файла, возвращаемых из запроса FSCTL_QUERY_FILE_LAYOUT.

Синтаксис

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

Члены

FileEntryCount

Количество записей файлов, следовать этой структуре.

FirstFileOffset

Смещение в буфере пользователя для первой записи файла.

Flags

Указывает формат возвращаемых записей макета. Может иметь значение 0 или следующее:

Ценность	Значение
QUERY_FILE_LAYOUT_SINGLE_INSTANCED	Возвращаются отдельные экземпляры записей потока и макета файлов. При установке для каждого потока возвращается только одна STREAM_LAYOUT_ENTRY структура, а для каждого файла возвращается только одна FILE_LAYOUT_ENTRY структура. Этот флаг всегда устанавливается для NTFS.

Ценность

Значение

QUERY_FILE_LAYOUT_SINGLE_INSTANCED

Возвращаются отдельные экземпляры записей потока и макета файлов. При установке для каждого потока возвращается только одна STREAM_LAYOUT_ENTRY структура, а для каждого файла возвращается только одна FILE_LAYOUT_ENTRY структура. Этот флаг всегда устанавливается для NTFS.

Reserved

Скрытный.

Замечания

Записи макета файла, следуйте QUERY_FILE_LAYOUT_OUTPUT структуре, определяются флагами, заданными в элементе флагов QUERY_FILE_LAYOUT_INPUT, предоставленных в качестве входных данных в запрос FSCTL_QUERY_FILE_LAYOUT. Ряд FILE_LAYOUT_ENTRY структур следует QUERY_FILE_LAYOUT_OUTPUT. В зависимости от выбранных записей, возвращаемых из запроса, смещения в FILE_LAYOUT_ENTRY указывают, где находятся дополнительные информационные записи в буфере пользователя.

Следующие структуры записей возвращаются при установке соответствующего флага включения в элементе Flags элемента QUERY_FILE_LAYOUT_INPUT.

Вход	Флаг включения
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

Если для одной FILE_LAYOUT_ENTRY структуры существует несколько записей одного типа, каждая информационная структура имеет элемент смещения, указывающий расположение следующей записи. Цепочка структур входа продолжается до тех пор, пока значение элемента смещения не равно 0.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 8.
заголовка	ntifs.h (include Ntifs.h)

См. также

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT

Поделиться через