QUERY_FILE_LAYOUT_OUTPUT structure (ntifs.h)

Article
08/07/2023

La structure QUERY_FILE_LAYOUT_OUTPUT sert d’en-tête pour les entrées de disposition de fichier qui sont retournées à partir d’une demande de FSCTL_QUERY_FILE_LAYOUT .

Syntaxe

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

Membres

FileEntryCount

Nombre d’entrées de fichier qui suivent cette structure.

FirstFileOffset

Décalage dans la mémoire tampon utilisateur pour la première entrée de fichier.

Flags

Indique le format des entrées de disposition retournées. Peut être égal à 0 ou à ce qui suit :

Valeur	Signification
QUERY_FILE_LAYOUT_SINGLE_INSTANCED	Des instances uniques d’entrées de flux et de disposition de fichier sont retournées. Lorsqu’elle est définie, une seule structure STREAM_LAYOUT_ENTRY est retournée par flux et une seule structure FILE_LAYOUT_ENTRY est retournée par fichier. Cet indicateur est toujours défini pour NTFS.

Reserved

Réservé.

Remarques

Les entrées de disposition de fichier qui suivent la structure QUERY_FILE_LAYOUT_OUTPUT sont déterminées par les indicateurs définis dans le membre Indicateurs de QUERY_FILE_LAYOUT_INPUT fournis comme entrée à la demande de FSCTL_QUERY_FILE_LAYOUT . Plusieurs structures FILE_LAYOUT_ENTRY suivent QUERY_FILE_LAYOUT_OUTPUT. Selon les entrées sélectionnées à retourner à partir d’une requête, les décalages dans FILE_LAYOUT_ENTRY indiquent où se trouvent les entrées d’informations supplémentaires dans la mémoire tampon utilisateur.

Les structures d’entrée suivantes sont retournées lorsque leur indicateur d’inclusion correspondant est défini dans le membre Indicateurs de QUERY_FILE_LAYOUT_INPUT.

Entrée	Indicateur d’inclusion
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

Lorsque plusieurs entrées du même type existent pour une structure de FILE_LAYOUT_ENTRY unique, chaque structure d’entrée d’information a un membre de décalage qui indique l’emplacement de l’entrée suivante. La chaîne de structures d’entrée se poursuit jusqu’à ce que la valeur du membre de décalage soit 0.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
En-tête	ntifs.h (include Ntifs.h)

Voir aussi

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT

Partager via