Share via

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

  • Статья

Структура 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.

Reserved

Зарезервировано.

Комментарии

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

Следующие структуры записей возвращаются, если соответствующий флаг включения установлен в элементе FlagsQUERY_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 (включая Ntifs.h)

См. также раздел

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT