estrutura QUERY_FILE_LAYOUT_OUTPUT (ntifs.h)

  • Artigo

A estrutura QUERY_FILE_LAYOUT_OUTPUT serve como um cabeçalho para as entradas de layout de arquivo retornadas de uma solicitação de FSCTL_QUERY_FILE_LAYOUT .

Sintaxe

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

Membros

FileEntryCount

O número de entradas de arquivo que seguem essa estrutura.

FirstFileOffset

O deslocamento no buffer de usuário para a primeira entrada de arquivo.

Flags

Indica o formato das entradas de layout retornadas. Pode ser 0 ou o seguinte:

Valor Significado
QUERY_FILE_LAYOUT_SINGLE_INSTANCED
 Instâncias individuais de entradas de layout de fluxo e arquivo são retornadas. Quando definida, apenas uma estrutura STREAM_LAYOUT_ENTRY é retornada por fluxo e apenas uma estrutura FILE_LAYOUT_ENTRY é retornada por arquivo. Esse sinalizador é sempre definido para NTFS.

Reserved

Reservado.

Comentários

As entradas de layout de arquivo que seguem a estrutura QUERY_FILE_LAYOUT_OUTPUT são determinadas pelos sinalizadores definidos no membro Flags do QUERY_FILE_LAYOUT_INPUT fornecido como entrada para a solicitação de FSCTL_QUERY_FILE_LAYOUT . Várias estruturas de FILE_LAYOUT_ENTRY seguem QUERY_FILE_LAYOUT_OUTPUT. Dependendo das entradas selecionadas para retornar de uma consulta, os deslocamentos em FILE_LAYOUT_ENTRY indicam onde as entradas informativas adicionais estão localizadas no buffer do usuário.

As estruturas de entrada a seguir são retornadas quando o sinalizador de inclusão correspondente é definido no membro Flags do QUERY_FILE_LAYOUT_INPUT.

Entrada Sinalizador de inclusão
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
 

Quando existem várias entradas do mesmo tipo para uma única estrutura de FILE_LAYOUT_ENTRY , cada estrutura de entrada informativa tem um membro de deslocamento que indica o local da próxima entrada. A cadeia de estruturas de entrada continua até que o valor do membro de deslocamento seja 0.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir de Windows 8.
Cabeçalho ntifs.h (inclua Ntifs.h)

Confira também

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT