code de contrôle FSCTL_SET_EXTERNAL_BACKING

Article
02/02/2024

Le code de contrôle FSCTL_SET_EXTERNAL_BACKING définit la source de stockage d’un fichier, par exemple un fichier WIM (Windows Image Format) ou un fichier compressé, par un fournisseur de stockage externe. Le contenu des fichiers sauvegardés en externe peut être généré sur des volumes autres que sur le volume où réside le fichier.

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

Paramètres

Instance [in] : FltFsControlFile uniquement. Pointeur de instance opaque pour l’appelant. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
FileObject [in] : FltFsControlFile uniquement. Objet pointeur de fichier du fichier pour lequel la sauvegarde est définie. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
FileHandle [in] : ZwFsControlFile uniquement. Handle du fichier pour lequel la sauvegarde est définie. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
FsControlCode [in] : code de contrôle de l’opération. Utilisez FSCTL_SET_EXTERNAL_BACKING pour cette opération.
InputBuffer [in] : pointeur vers la mémoire tampon d’entrée, qui contient WOF_EXTERNAL_INFO structure suivie des données du fournisseur. Pour les fichiers adossés à WIM, WOF_EXTERNAL_INFO est suivi d’une structure WIM_PROVIDER_EXTERNAL_INFO .
InputBufferLength [in] : taille des données fournies dans InputBuffer.
OutputBuffer [out] : Aucun. valeur de l’en-tête définie sur Null.
OutputBufferLength [in] : défini sur 0.

Bloc d’état

FltFsControlFile ou ZwFsControlFile retourne STATUS_SUCCESS si l’opération réussit. Sinon, les valeurs NTSTATUS appropriées sont retournées.

Remarques

Lorsque le fournisseur de stockage pour la source de données ajoutée est le fournisseur WIM, la mémoire tampon d’entrée contient une structure WOF_EXTERNAL_INFO suivie d’une structure WIM_PROVIDER_EXTERNAL_INFO . Dans ce cas , l’élément InputBufferLength sera sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO).

Les fichiers compressés individuellement offrent une bonne compression pour les données qui ne seront pas modifiées, y compris les fichiers exécutables. Si ceux-ci sont ouverts pour l’écriture, le fichier est décompressé de manière transparente. Pour spécifier un fichier compressé individuellement, la mémoire tampon d’entrée contient une structure WOF_EXTERNAL_INFO suivie d’une structure FILE_PROVIDER_EXTERNAL_INFO_V1 . Dans ce cas , l’élément InputBufferLength sera sizeof(WOF_EXTERNAL_INFO) + sizeof(FILE_PROVIDER_EXTERNAL_INFO_V1). Des fichiers compressés individuels sont disponibles à partir de Windows 10.