Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 d’instance opaque pour l’appelant. Ce paramètre est obligatoire et ne peut pas être 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 être NULL.
FileHandle [in] : ZwFsControlFile uniquement. Handle du volume auquel la superposition est ajoutée. Ce paramètre est obligatoire et ne peut pas être 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) ainsi que la taille de toutes les données d’entrée de fournisseur supplémentaires.
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 | Sens |
|---|---|
| STATUS_ACCÈS_REFUSÉ | Le demandeur n’a pas de privilèges d’administration. |
| 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. |
| ERREUR_INTERNE_STATUT | Le volume demandé n’est pas accessible. |
| STATUS_INVALID_DEVICE_REQUEST | Le service de stockage n’est pas présent ou ne démarre pas. |
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 . InputBufferLength dans ce cas sera sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_ADD_OVERLAY_INPUT). Une fois la requête terminée, les données pointées par OutputBuffer contiennent une valeur LARGE_INTEGER unique, 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.
Spécifications
| Type de condition requise | Besoin |
|---|---|
| Client minimum pris en charge | Mise à jour Windows 8.1 |
| En-tête de page | Ntifs.h (include Ntifs.h ou Fltkernel.h) |