код элемента управления FSCTL_ADD_OVERLAY

  • Статья

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

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

Параметры

  • Экземпляр [in]: только FltFsControlFile . Указатель непрозрачного экземпляра для вызывающего объекта. Этот параметр является обязательным и не может иметь значение NULL.

  • FileObject: [in]: только FltFsControlFile . Объект указателя файла тома, к которому добавляется наложение. Этот параметр является обязательным и не может иметь значение NULL.

  • FileHandle [in]: только ZwFsControlFile . Дескриптор тома, к которому добавляется наложение. Этот параметр является обязательным и не может иметь значение NULL.

  • FsControlCode [in]: код элемента управления для операции. Используйте FSCTL_ADD_OVERLAY для этой операции.

  • InputBuffer [in]: указатель на входной буфер, который должен содержать WOF_EXTERNAL_INFO структуру. При необходимости дополнительные данные, относящиеся к поставщику, включаются сразу после WOF_EXTERNAL_INFO.

  • InputBufferLength [in]: задайте значение sizeof(WOF_EXTERNAL_INFO) плюс размер любых дополнительных входных данных поставщика.

  • OutputBuffer [out]: указатель на выходной буфер, который содержит все результирующий сведения из операции добавления.

  • OutputBufferLength [out]: размер буфера, на который указывает OutputBuffer.

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

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

Код Значение
STATUS_ACCESS_DENIED Инициатор запроса не имеет прав администратора.
STATUS_BUFFER_TOO_SMALL Длина выходного буфера, на который указывает OutputBuffer, и указанная параметром OutputBufferLength, слишком мала.
STATUS_INTERNAL_ERROR Запрошенный том недоступен.
STATUS_INVALID_DEVICE_REQUEST Резервная служба отсутствует или не запущена.

Комментарии

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

Другие вспомогательные поставщики будут определять собственные структуры входных параметров и типы выходных данных.

Требования

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

См. также раздел

FSCTL_REMOVE_OVERLAY

FSCTL_SUSPEND_OVERLAY

FSCTL_UPDATE_OVERLAY

FSCTL_GET_EXTERNAL_BACKING

FSCTL_SET_EXTERNAL_BACKING