FSCTL_ADD_OVERLAY控制代码

FSCTL_ADD_OVERLAY 代码将新的外部支持源添加到卷的命名空间。 此后备源可以是 WIM Windows映像 (格式) 源。

若要执行此操作,请通过以下参数调用 FltFsControlFileZwFsControlFile

Parameters

实例 [in]
仅 FltFsControlFile 。 调用方的不透明实例指针。 此参数是必需的,不能为 NULL。

FileObject [in]
仅 FltFsControlFile 。 覆盖添加到的卷的文件指针对象。 此参数是必需的,不能为 NULL。

FileHandle [in]
仅 ZwFsControlFile 。 要添加其覆盖的卷的句柄。 此参数是必需的,不能为 NULL。

FsControlCode [in]
操作的控制代码。 对 FSCTL_ADD_OVERLAY 使用方法。

InputBuffer
指向输入缓冲区的指针,该缓冲区 必须包含WOF_EXTERNAL_INFO 结构。 如果需要,其他提供程序特定的数据会立即包含在WOF_EXTERNAL_INFO。

InputBufferLength [in]
将 设置为 sizeof (WOF_EXTERNAL_INFO) 输入数据的大小加上任何其他提供程序输入数据的大小。

OutputBuffer [out]
指向输出缓冲区的指针,该缓冲区包含来自添加操作的任何结果信息。

OutputBufferLength [out]
OutputBuffer 指向的缓冲区的大小

状态块

如果操作成功,FltFsControlFileZwFsControlFile STATUS_SUCCESS返回 。 否则,相应的函数可能会返回以下 NTSTATUS 值之一。

术语 说明

STATUS_ACCESS_DENIED

请求者没有管理权限。

STATUS_BUFFER_TOO_SMALL

OutputBuffer 指向的输出缓冲区长度(由 OutputBufferLength 指定)太小。

STATUS_INTERNAL_ERROR

请求的卷不可访问。

STATUS_INVALID_DEVICE_REQUEST

支持服务不存在或尚未启动。

备注

如果添加的支持源是 WINDOWS 映像格式 (WIM) 文件,则输入缓冲区将包含一个 WOF_EXTERNAL_INFO 结构,后 WIM_PROVIDER_ADD_OVERLAY_INPUT 结构。 在这种情况下,InputBufferLength 的大小 (WOF_EXTERNAL_INFO) + ( 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