FSCTL_ADD_OVERLAY código de control

Artículo
03/14/2023

El código de control FSCTL_ADD_OVERLAY agrega un nuevo origen de respaldo externo al espacio de nombres de un volumen. Este origen de respaldo puede ser un archivo de Formato de imagen de Windows (WIM).

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

Parámetros

Instancia [in]: Solo FltFsControlFile . 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 volumen al que se agrega la superposición. Este parámetro es obligatorio y no puede ser NULL.
FileHandle [in]: ZwFsControlFile solo. Identificador del volumen al que se agrega la superposición. Este parámetro es obligatorio y no puede ser NULL.
FsControlCode [in]: código de control para la operación. Use FSCTL_ADD_OVERLAY para esta operación.
InputBuffer [in]: puntero al búfer de entrada, que debe contener una estructura de WOF_EXTERNAL_INFO . Cuando sea necesario, se incluyen datos específicos del proveedor adicionales inmediatamente después de WOF_EXTERNAL_INFO.
InputBufferLength [in]: establezca en sizeof(WOF_EXTERNAL_INFO) más el tamaño de los datos de entrada adicionales del proveedor.
OutputBuffer [out]: puntero al búfer de salida, que contiene información resultante de la operación de adición.
OutputBufferLength [out]: tamaño del búfer al que apunta OutputBuffer.

Bloque de estado

FltFsControlFile o ZwFsControlFile devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, la función adecuada podría devolver uno de los siguientes valores NTSTATUS.

Código	Significado
STATUS_ACCESS_DENIED	El solicitante no tiene privilegios administrativos.
STATUS_BUFFER_TOO_SMALL	La longitud del búfer de salida al que apunta OutputBuffer, y especificada por OutputBufferLength, es demasiado pequeña.
STATUS_INTERNAL_ERROR	El volumen solicitado no es accesible.
STATUS_INVALID_DEVICE_REQUEST	El servicio de respaldo no está presente o no se ha iniciado.

Comentarios

Cuando el origen de respaldo agregado es un archivo de Formato de imagen de Windows (WIM), el búfer de entrada contendrá una estructura de WOF_EXTERNAL_INFO seguida de una estructura de WIM_PROVIDER_ADD_OVERLAY_INPUT . En este caso , InputBufferLength será sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_ADD_OVERLAY_INPUT). Al finalizar la solicitud, los datos a los que apunta OutputBuffer contienen un único valor de LARGE_INTEGER que es el nuevo identificador de origen de datos para el archivo WIM.

Otros proveedores de respaldo definirán sus propias estructuras de parámetros de entrada y tipos de datos de salida específicos.