FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)

Article
12/21/2024

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 fichiers à interroger.

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

Taille de la structure FILE_REGION_INPUT qui InputBuffer pointe vers, 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 qui OutputBuffer pointe vers, 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é à l’utilisation du 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 d’instance opaque pour l’appelant. Ce paramètre est obligatoire et ne peut pas être NULL.
FileObject	[in] Pour FltFsControlFile uniquement. Pointeur d’objet de fichier pour le fichier ou le répertoire qui est la cible de cette requête. Ce paramètre est obligatoire et ne peut pas être NULL.
FileHandle	[in] Pour ZwFsControlFile uniquement. Handle de fichier du fichier ou du répertoire qui est la cible de cette requête. Ce paramètre est obligatoire et ne peut pas être NULL.
IoStatusBlock	[out] Pour ZwFsControlFile uniquement. Pointeur vers une structure IO_STATUS_BLOCK dans laquelle l’état final de la requête est retourné.
FsControlCode	[in] Défini sur FSCTL_QUERY_FILE_REGIONS.
InputBuffer	[in/optional] Pointeur vers une structure FILE_REGION_INPUT qui indique la ou les régions de fichiers à interroger.
InputBufferLength	[in] Taille de la mémoire tampon qui InputBuffer pointe vers, 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 qui OutputBuffer pointe vers, 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 à OutputBuffer.

Valeurs de retour

FSCTL_QUERY_FILE_REGIONS retourne STATUS_SUCCESS une fois l’achèvement réussi ; sinon, elle 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.