Compartir a través de

estructura QUERY_FILE_LAYOUT_OUTPUT (ntifs.h)

  • Artículo

La estructura QUERY_FILE_LAYOUT_OUTPUT actúa como encabezado para las entradas de diseño de archivo que se devuelven de una solicitud de FSCTL_QUERY_FILE_LAYOUT .

Sintaxis

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

Miembros

FileEntryCount

Número de entradas de archivo que siguen esta estructura.

FirstFileOffset

Desplazamiento en el búfer de usuario para la primera entrada de archivo.

Flags

Indica el formato de las entradas de diseño devueltas. Puede ser 0 o lo siguiente:

Valor Significado
QUERY_FILE_LAYOUT_SINGLE_INSTANCED
 Se devuelven instancias únicas de entradas de diseño de secuencia y archivo. Cuando se establece, solo se devuelve una estructura STREAM_LAYOUT_ENTRY por secuencia y solo se devuelve una estructura FILE_LAYOUT_ENTRY por archivo. Esta marca siempre se establece para NTFS.

Reserved

Reservado.

Comentarios

Las entradas de diseño de archivo que siguen a la estructura de QUERY_FILE_LAYOUT_OUTPUT se determinan mediante las marcas establecidas en el miembro Flags de QUERY_FILE_LAYOUT_INPUT proporcionado como entrada para la solicitud de FSCTL_QUERY_FILE_LAYOUT . Varias estructuras de FILE_LAYOUT_ENTRY siguen QUERY_FILE_LAYOUT_OUTPUT. Según las entradas seleccionadas para devolver de una consulta, los desplazamientos en FILE_LAYOUT_ENTRY indican dónde se encuentran las entradas informativas adicionales en el búfer de usuario.

Las siguientes estructuras de entrada se devuelven cuando se establece su marca de inclusión correspondiente en el miembro Flags de QUERY_FILE_LAYOUT_INPUT.

Entrada Marca de inclusión
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
 

Cuando existen varias entradas del mismo tipo para una única estructura de FILE_LAYOUT_ENTRY , cada estructura de entrada informativa tiene un miembro de desplazamiento que indica la ubicación de la entrada siguiente. La cadena de estructuras de entrada continúa hasta que el valor del miembro de desplazamiento es 0.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 8.
Encabezado ntifs.h (incluya Ntifs.h)

Consulte también

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT