FSCTL_UPDATE_OVERLAY控制代码

FSCTL_UPDATE_OVERLAY控制代码更新附加到卷的后备源的新数据源标识符。

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

参数

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

  • FileObject [in]: 仅 FltFsControlFile 。 为其更新覆盖的卷的文件指针对象。 此参数是必需的,不能为 NULL。

  • FileHandle [in]:仅 ZwFsControlFile 。 为其更新覆盖的卷的句柄。 此参数是必需的,不能为 NULL。

  • FsControlCode [in]:操作的控制代码。 对此操作使用 FSCTL_UPDATE_OVERLAY

  • InputBuffer [in]:指向输入缓冲区的指针,该缓冲区必须包含 WOF_EXTERNAL_INFO 结构。 如果需要,在 WOF_EXTERNAL_INFO后立即包含其他提供程序特定的数据。 如果提供程序是 WIM 文件, 则WOF_EXTERNAL_INFO 后会包含 WIM_PROVIDER_UPDATE_OVERLAY_INPUT结构。

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

  • OutputBuffer [out]:未使用。 设置为 NULL。

  • OutputBufferLength [in]:设置为 0。

状态块

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

代码 含义
STATUS_ACCESS_DENIED 请求者没有管理权限。
STATUS_BUFFER_TOO_SMALL InputBuffer 指向并由 InputBufferLength 指定的输入缓冲区的长度太小。
STATUS_INTERNAL_ERROR 无法访问请求的卷。
STATUS_INVALID_DEVICE_REQUEST 后备服务不存在或未启动。

注解

当要更新的数据源是 Windows 图像处理格式 (WIM) 文件时,输入缓冲区将包含 WOF_EXTERNAL_INFO 结构,后跟 WIM_PROVIDER_UPDATE_OVERLAY_INPUT 结构。 在本例中, InputBufferLength的大小 为 (WOF_EXTERNAL_INFO) + sizeof (WIM_PROVIDER_UPDATE_OVERLAY_INPUT) 。 WIM_PROVIDER_UPDATE_OVERLAY_INPUT 中的 DataSourceId 值必须为以前在FSCTL_ADD_OVERLAY请求中添加的 WIM 文件。

其他后备提供程序将定义其自己的特定输入参数结构。

要求

要求类型 要求
最低受支持的客户端 Windows 8.1 更新
标头 Ntifs.h (包括 Ntifs.hFltkernel.h)

另请参阅

FSCTL_ADD_OVERLAY

FSCTL_REMOVE_OVERLAY

FSCTL_SUSPEND_OVERLAY

FSCTL_GET_EXTERNAL_BACKING

FSCTL_SET_EXTERNAL_BACKING