FSCTL_SET_EXTERNAL_BACKING código de control

Artículo
03/14/2023

El código de control FSCTL_SET_EXTERNAL_BACKING establece el origen de respaldo de un archivo, como un archivo con formato de imagen de Windows (WIM) o un archivo comprimido, mediante un proveedor de respaldo externo. El contenido de los archivos respaldados externamente puede tener como origen volúmenes distintos del volumen en el que reside el archivo.

Para realizar esta operación, llame a FltFsControlFile o ZwFsControlFile con los parámetros siguientes.

Parámetros

Instancia [in]: FltFsControlFile solo. Puntero de instancia opaco para el autor de la llamada. Este parámetro es obligatorio y no puede ser NULL.
FileObject [in]: FltFsControlFile solo. Objeto de puntero de archivo del archivo para el que se establece la copia de seguridad. Este parámetro es obligatorio y no puede ser NULL.
FileHandle [in]: ZwFsControlFile solo. Identificador del archivo para el que se establece la copia de seguridad. Este parámetro es obligatorio y no puede ser NULL.
FsControlCode [in]: el código de control de la operación. Use FSCTL_SET_EXTERNAL_BACKING para esta operación.
InputBuffer [in]: puntero al búfer de entrada, que contiene WOF_EXTERNAL_INFO estructura seguida de los datos del proveedor. En el caso de los archivos respaldados por WIM, WOF_EXTERNAL_INFO va seguido de una estructura de WIM_PROVIDER_EXTERNAL_INFO .
InputBufferLength [in]: Tamaño de los datos proporcionados en InputBuffer.
OutputBuffer [out]: Ninguno. Definición en NULL
OutputBufferLength [in]: Establezca en 0.

Bloque de estado

FltFsControlFile o ZwFsControlFile devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, se devuelven los valores NTSTATUS adecuados.

Comentarios

Cuando el proveedor de respaldo para el origen de datos agregado es el proveedor WIM, el búfer de entrada contendrá una estructura de WOF_EXTERNAL_INFO seguida de una estructura de WIM_PROVIDER_EXTERNAL_INFO . InputBufferLength en este caso será sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO).

Los archivos comprimidos individualmente ofrecen una buena compresión para los datos que no se modificarán, incluidos los archivos ejecutables. Si se abren para escribir, el archivo se descomprime de forma transparente. Para especificar un archivo comprimido individualmente, el búfer de entrada contendrá una estructura de WOF_EXTERNAL_INFO seguida de una estructura de FILE_PROVIDER_EXTERNAL_INFO_V1 . InputBufferLength en este caso será sizeof(WOF_EXTERNAL_INFO) + sizeof(FILE_PROVIDER_EXTERNAL_INFO_V1). Los archivos comprimidos individuales están disponibles a partir de Windows 10.