FSCTL_ADD_OVERLAY código de controle

Artigo
02/02/2024

O código de controle FSCTL_ADD_OVERLAY adiciona uma nova fonte de suporte externa ao namespace de um volume. Essa fonte de suporte pode ser um arquivo WIM (Formato de Imagem do Windows).

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 volume ao qual a sobreposição é adicionada. Esse parâmetro é necessário e não pode ser NULL.
FileHandle [in]: somente ZwFsControlFile . O identificador do volume ao qual a sobreposição é adicionada. Esse parâmetro é necessário e não pode ser NULL.
FsControlCode [in]: o código de controle da operação. Use FSCTL_ADD_OVERLAY para esta operação.
InputBuffer [in]: um ponteiro para o buffer de entrada, que deve conter uma estrutura WOF_EXTERNAL_INFO . Quando necessário, dados adicionais específicos do provedor são incluídos imediatamente após WOF_EXTERNAL_INFO.
InputBufferLength [in]: defina como sizeof(WOF_EXTERNAL_INFO) mais o tamanho de quaisquer dados de entrada de provedor adicionais.
OutputBuffer [out]: um ponteiro para o buffer de saída, que contém todas as informações resultantes da operação de adição.
OutputBufferLength [out]: tamanho do buffer apontado por OutputBuffer.

Bloco de status

FltFsControlFile ou ZwFsControlFile retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, a função apropriada pode retornar um dos seguintes valores NTSTATUS.

Código	Significado
STATUS_ACCESS_DENIED	O solicitante não tem privilégios administrativos.
STATUS_BUFFER_TOO_SMALL	O comprimento do buffer de saída apontado por OutputBuffer e especificado por OutputBufferLength é muito pequeno.
STATUS_INTERNAL_ERROR	O volume solicitado não está acessível.
STATUS_INVALID_DEVICE_REQUEST	O serviço de backup não está presente ou não foi iniciado.

Comentários

Quando a fonte de suporte adicionada for um arquivo WIM (Windows Imaging Format), o buffer de entrada conterá uma estrutura WOF_EXTERNAL_INFO seguida por uma estrutura WIM_PROVIDER_ADD_OVERLAY_INPUT . O InputBufferLength nesse caso será sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_ADD_OVERLAY_INPUT). Após a conclusão da solicitação, os dados apontados pelo OutputBuffer contêm um único valor de LARGE_INTEGER que é o novo identificador de fonte de dados para o arquivo WIM.

Outros provedores de suporte definirão suas próprias estruturas de parâmetro de entrada específicas e tipos de dados de saída.