FSCTL_SHUFFLE_FILE IOCTL (ntifs.h)
FSCTL_SHUFFLE_FILE ajoute ou supprime l’allocation dans le fichier spécifié.
Code principal
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éfinit la valeur zéro.
Bloc d’état
Valeurs de retour
FSCTL_SHUFFLE_FILE retourne STATUS_SUCCESS une fois l’exécution réussie ; sinon, il retourne un code NTSTATUS tel que l’un des éléments suivants.
Code de retour | Signification |
---|---|
STATUS_ACCESS_DENIED | Pour diverses raisons, y compris seuls les appels en mode noyau sont autorisés ou le volume est verrouillé. |
STATUS_BUFFER_TOO_SMALL | La longueur de la mémoire tampon d’entrée spécifiée est inférieure à sizeof(SHUFFLE_FILE_DATA). |
STATUS_MEDIA_WRITE_PROTECTED | La lecture aléatoire n’est pas autorisée 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 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 qui contient le status final de la demande. |
FsControlCode | [in] Définissez sur FSCTL_SHUFFLE_FILE. |
InputBuffer | [in] Consultez Paramètres IOCTL. |
InputBufferLength | [in] Consultez Paramètres IOCTL. |
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 10, version 1809 |
En-tête | ntifs.h |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour