FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)

Article
12/21/2024

FSCTL_SHUFFLE_FILE ajoute ou supprime l’allocation du fichier spécifié.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d’entrée

Pointeur vers une structure SHUFFLE_FILE_DATA qui décrit l’allocation à mélanger.

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

Taille en octets de la mémoire tampon d’entrée.

Mémoire tampon de sortie

Aucun; défini sur NULL.

Longueur de la mémoire tampon de sortie

Défini sur zéro.

Bloc d’état

Valeurs de retour

FSCTL_SHUFFLE_FILE retourne STATUS_SUCCESS une fois l’achèvement réussi ; sinon, elle retourne un code NTSTATUS tel que l’un des éléments suivants.

Retourner le code	Signification
STATUS_ACCESS_DENIED	Pour diverses raisons, y compris uniquement les appels en mode noyau sont autorisés, ou le volume est verrouillé.
STATUS_BUFFER_TOO_SMALL	La longueur de mémoire tampon d’entrée spécifiée est inférieure à sizeof(SHUFFLE_FILE_DATA).
STATUS_MEDIA_WRITE_PROTECTED	Le shuffling n’est pas autorisé sur un volume en lecture seule.

Remarques

Ce code de contrôle entraîne le déplacement des données dans le fichier. L’appelant est responsable de la protection/de l’effacement des données aléatoires dans l’allocation ajoutée.

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 qui contient l’état final de la requête.
FsControlCode	[in] Défini sur FSCTL_SHUFFLE_FILE.
InputBuffer	[in] Consultez les paramètres IOCTL.
InputBufferLength	[in] Consultez les paramètres IOCTL.