Função CcMdlWriteComplete (ntifs.h)

Artigo
12/21/2024

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 de MDL retornado por CcPrepareMdlWrite.

Valor de retorno

Nenhum

Observações

Os sistemas de arquivos chamam CcMdlWriteComplete para liberar as listas de descritores de memória (MDL) criadas pelo CcPrepareMdlWrite para um arquivo armazenado em cache e marcar o intervalo de bytes especificado para gravação. Todas as páginas físicas 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 gerar 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 para NULL.

Antes de usar CcMdlWriteComplete, os desenvolvedores do sistema de arquivos são altamente 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

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Consulte também

CcMdlWriteAbort

CcPrepareMdlWrite

Compartilhar via