code de contrôle FSCTL_ADD_OVERLAY

Article
03/14/2023

Le code de contrôle FSCTL_ADD_OVERLAY ajoute une nouvelle source de stockage externe à l’espace de noms d’un volume. Cette source de stockage peut être un fichier WIM (Windows Image Format).

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 volume auquel la superposition est ajoutée. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
FileHandle [in] : ZwFsControlFile uniquement. Handle du volume auquel la superposition est ajoutée. 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_ADD_OVERLAY pour cette opération.
InputBuffer [in] : pointeur vers la mémoire tampon d’entrée, qui doit contenir une structure WOF_EXTERNAL_INFO . Si nécessaire, des données spécifiques au fournisseur supplémentaires sont incluses immédiatement après WOF_EXTERNAL_INFO.
InputBufferLength [in] : défini sur sizeof(WOF_EXTERNAL_INFO) plus la taille des données d’entrée supplémentaires du fournisseur.
OutputBuffer [out] : pointeur vers la mémoire tampon de sortie, qui contient toutes les informations résultantes de l’opération d’ajout.
OutputBufferLength [out] : taille de la mémoire tampon pointée par OutputBuffer.

Bloc d’état

FltFsControlFile ou ZwFsControlFile retourne STATUS_SUCCESS si l’opération réussit. Sinon, la fonction appropriée peut retourner l’une des valeurs NTSTATUS suivantes.

Code	Signification
STATUS_ACCESS_DENIED	Le demandeur ne dispose pas de privilèges administratifs.
STATUS_BUFFER_TOO_SMALL	La longueur de la mémoire tampon de sortie pointée par OutputBuffer, et spécifiée par OutputBufferLength, est trop petite.
STATUS_INTERNAL_ERROR	Le volume demandé n’est pas accessible.
STATUS_INVALID_DEVICE_REQUEST	Le service de sauvegarde n’est pas présent ou n’est pas démarré.

Remarques

Lorsque la source de stockage ajoutée est un fichier WIM (Windows Imaging Format), la mémoire tampon d’entrée contient une structure WOF_EXTERNAL_INFO suivie d’une structure WIM_PROVIDER_ADD_OVERLAY_INPUT . Dans ce cas , l’élément InputBufferLength sera sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_ADD_OVERLAY_INPUT). Une fois la demande terminée, les données pointées par OutputBuffer contiennent une seule valeur LARGE_INTEGER qui est le nouvel identificateur de source de données pour le fichier WIM.

D’autres fournisseurs de stockage définissent leurs propres structures de paramètres d’entrée et types de données de sortie spécifiques.