Função CcMdlWriteComplete (ntifs.h)

A rotina CcMdlWriteComplete libera as listas de descritores de memória (MDL) criadas por CcPrepareMdlWrite para um arquivo armazenado em cache.

Sintaxe

void CcMdlWriteComplete(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] PMDL           MdlChain
);

Parâmetros

[in] FileObject

Ponteiro do objeto de arquivo que foi passado para CcPrepareMdlWrite.

[in] FileOffset

Valor de FileOffset que foi passado para CcPrepareMdlWrite.

[in] MdlChain

Endereço da cadeia MDL retornada por CcPrepareMdlWrite.

Retornar valor

Nenhum

Comentários

Os sistemas de arquivos chamam CcMdlWriteComplete para liberar as listas de descritores de memória (MDL) criadas por CcPrepareMdlWrite para um arquivo armazenado em cache e para marcar o intervalo de bytes especificado para gravação. Todas as páginas físicas que foram bloqueadas são desbloqueadas. Todas as páginas mapeadas não são mapeadas.

Se o sinalizador FO_WRITE_THROUGH for definido no objeto de arquivo apontado pelo parâmetro FileObject , os dados do arquivo serão imediatamente liberados para o disco. Essa operação de liberação entra novamente no sistema de arquivos e pode fazer com que CcMdlWriteComplete gere uma exceção se a operação de liberação falhar. Nesse caso, o MDL não foi liberado e o chamador pode tentar novamente a operação.

Depois que CcMdlWriteComplete for chamado com êxito para uma operação de IRP_MN_COMPLETE, o chamador deverá definir o campo MdlAddress do IRP como NULL.

Antes de usar CcMdlWriteComplete, os desenvolvedores do sistema de arquivos são fortemente incentivados a estudar a maneira como essa rotina é usada na amostra FASTFAT.

Cada chamada para CcPrepareMdlWrite deve ser seguida por uma chamada para CcMdlWriteComplete ou CcMdlWriteAbort.

Requisitos

Confira também

CcMdlWriteAbort

CcPrepareMdlWrite