Код элемента управления FSCTL_SET_EXTERNAL_BACKING

Статья
03/14/2023

Код элемента управления FSCTL_SET_EXTERNAL_BACKING задает резервный источник для файла, например WIM-файла или сжатый файл, внешним поставщиком резервной копии. Содержимое для файлов с внешней резервной копией может быть источником на томах, отличных от тома, на котором находится файл.

Для выполнения этой операции вызовите FltFsControlFile или ZwFsControlFile со следующими параметрами.

Параметры

Экземпляр [in]: только FltFsControlFile . Указатель непрозрачного экземпляра для вызывающего объекта. Этот параметр является обязательным и не может иметь значение NULL.
FileObject [in]: только FltFsControlFile . Объект указателя файла, для которого задано резервное копирование. Этот параметр является обязательным и не может иметь значение NULL.
FileHandle [in]: только ZwFsControlFile . Дескриптор файла, для которого задается резервное копирование. Этот параметр является обязательным и не может иметь значение NULL.
FsControlCode [in]: код элемента управления для операции. Используйте FSCTL_SET_EXTERNAL_BACKING для этой операции.
InputBuffer [in]: указатель на входной буфер, который содержит WOF_EXTERNAL_INFO структуру, за которой следуют данные поставщика. Для файлов с поддержкой WIM WOF_EXTERNAL_INFO следует структура WIM_PROVIDER_EXTERNAL_INFO .
InputBufferLength [in]: размер данных, предоставленных в InputBuffer.
OutputBuffer [out]: нет. задано значение NULL.
OutputBufferLength [in]: задайте значение 0.

Блок состояния

FltFsControlFile или ZwFsControlFile возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае возвращаются соответствующие значения NTSTATUS.

Если резервным поставщиком для добавляемого источника данных является поставщик WIM, входной буфер будет содержать WOF_EXTERNAL_INFO структуру, за которой следует структура WIM_PROVIDER_EXTERNAL_INFO . InputBufferLength в этом случае будет sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO).

Сжатые по отдельности файлы обеспечивают хорошее сжатие для данных, которые не будут изменены, включая исполняемые файлы. Если они открыты для записи, файл будет прозрачно распаковывлен. Чтобы указать отдельный сжатый файл, входной буфер будет содержать WOF_EXTERNAL_INFO структуру, за которой следует структура FILE_PROVIDER_EXTERNAL_INFO_V1 . InputBufferLength в этом случае будет sizeof(WOF_EXTERNAL_INFO) + sizeof(FILE_PROVIDER_EXTERNAL_INFO_V1). Отдельные сжатые файлы доступны, начиная с Windows 10.

Требования

Тип требования	Требование
Минимальная версия клиента	Windows 8.1 с обновлением
Заголовок	Ntifs.h (включая Ntifs.h или Fltkernel.h)