FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)

Article
11/14/2023

FSCTL_QUERY_FILE_REGIONS interroge une liste de régions de fichiers, en fonction d’un paramètre d’utilisation spécifié, pour le fichier associé au handle sur lequel ce FSCTL a été appelé. Ce message contient un élément de données FILE_REGION_INPUT facultatif. Si aucun paramètre FILE_REGION_INPUT n’est spécifié, les informations relatives à la taille entière du fichier sont retournées.

Code principal

FSCTL_QUERY_FILE_REGIONS

Mémoire tampon d'entrée

Pointeur vers une structure FILE_REGION_INPUT qui indique la ou les régions de fichier à interroger.

Longueur de la mémoire tampon d’entrée

Taille de la structure de FILE_REGION_INPUT vers laquelle pointe InputBuffer , en octets.

Mémoire tampon de sortie

Pointeur vers une structure FILE_REGION_OUTPUT dans laquelle les résultats de la requête sont retournés.

Longueur de la mémoire tampon de sortie

Taille de la mémoire tampon vers laquelle pointe OutputBuffer , en octets.

Mémoire tampon d’entrée/sortie

n/a

Longueur de la mémoire tampon d’entrée/sortie

n/a

Bloc d’état

Réservé pour le système.

Remarques

Pour effectuer cette opération, appelez FltFsControlFile ou ZwFsControlFile avec les paramètres suivants.

Paramètre	Description
Instance	[in] Pour FltFsControlFile uniquement. Pointeur de instance opaque pour l’appelant. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
FileObject	[in] Pour FltFsControlFile uniquement. Pointeur d’objet de fichier pour le fichier ou le répertoire qui est la cible de cette demande. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
FileHandle	[in] Pour ZwFsControlFile uniquement. Handle de fichier du fichier ou du répertoire qui est la cible de cette demande. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
IoStatusBlock	[out] Pour ZwFsControlFile uniquement. Pointeur vers une structure de IO_STATUS_BLOCK dans laquelle la status finale de la requête est retournée.
FsControlCode	[in] Définissez sur FSCTL_QUERY_FILE_REGIONS.
InputBuffer	[in/optional] Pointeur vers une structure FILE_REGION_INPUT qui indique la ou les régions de fichier à interroger.
InputBufferLength	[in] Taille de la mémoire tampon vers laquelle pointe InputBuffer , en octets.
OutputBuffer	[out] Pointeur vers une structure FILE_REGION_OUTPUT dans laquelle les résultats de la requête sont retournés.
OutputBufferLength	[out] Taille de la mémoire tampon vers laquelle pointe OutputBuffer , en octets.
LengthReturned	[out] Pointeur vers une variable allouée par l’appelant qui reçoit la taille en octets des informations retournées dans la mémoire tampon dans OutputBuffer.

Valeurs de retour

FSCTL_QUERY_FILE_REGIONS retourne STATUS_SUCCESS en cas de réussite de l’exécution ; sinon, il retourne un code d’erreur. Une fois l’opération terminée, l’appelant doit d’abord vérifier que IoStatus.Information est supérieur ou égal à LengthReturned avant d’accéder aux informations retournées dans OutputBuffer.