FSCTL_SET_EXTERNAL_BACKING código de controle

Artigo
03/14/2023

O código de controle FSCTL_SET_EXTERNAL_BACKING define a fonte de suporte para um arquivo, como um arquivo WIM (Formato de Imagem do Windows) ou um arquivo compactado, por um provedor de suporte externo. O conteúdo para arquivos com backup externo pode ser originado em volumes diferentes do volume em que o arquivo reside.

Para executar essa operação, chame FltFsControlFile ou ZwFsControlFile com os parâmetros a seguir.

Parâmetros

Instância [in]: somente FltFsControlFile . Um ponteiro de instância opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL.
FileObject [in]: somente FltFsControlFile . O objeto de ponteiro de arquivo do arquivo para o qual o backup está definido. Esse parâmetro é necessário e não pode ser NULL.
FileHandle [in]: somente ZwFsControlFile . O identificador do arquivo para o qual o backup está definido. Esse parâmetro é necessário e não pode ser NULL.
FsControlCode [in]: o código de controle da operação. Use FSCTL_SET_EXTERNAL_BACKING para esta operação.
InputBuffer [in]: um ponteiro para o buffer de entrada, que contém WOF_EXTERNAL_INFO estrutura seguida pelos dados do provedor. Para arquivos com backup de WIM, WOF_EXTERNAL_INFO é seguido por uma estrutura de WIM_PROVIDER_EXTERNAL_INFO .
InputBufferLength [in]: tamanho dos dados fornecidos no InputBuffer.
OutputBuffer [out]: Nenhum. Definido como NULL.
OutputBufferLength [in]: definido como 0.

Bloco de status

FltFsControlFile ou ZwFsControlFile retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, os valores NTSTATUS apropriados serão retornados.

Comentários

Quando o provedor de suporte para a fonte de dados adicionada for o provedor WIM, o buffer de entrada conterá uma estrutura WOF_EXTERNAL_INFO seguida por uma estrutura de WIM_PROVIDER_EXTERNAL_INFO . O InputBufferLength nesse caso será sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO).

Arquivos compactados individualmente oferecem boa compactação para dados que não serão modificados, incluindo arquivos executáveis. Se eles forem abertos para gravação, o arquivo será descompactado de forma transparente. Para especificar um arquivo compactado individualmente, o buffer de entrada conterá uma estrutura WOF_EXTERNAL_INFO seguida por uma estrutura FILE_PROVIDER_EXTERNAL_INFO_V1 . O InputBufferLength nesse caso será sizeof(WOF_EXTERNAL_INFO) + sizeof(FILE_PROVIDER_EXTERNAL_INFO_V1). Arquivos compactados individuais estão disponíveis a partir do Windows 10.