Função FsRtlMdlWriteCompleteDev (ntifs.h)

Artigo
12/20/2024

A rotina FsRtlMdlWriteCompleteDev libera os recursos que FsRtlPrepareMdlWriteDev alocado.

Sintaxe

BOOLEAN FsRtlMdlWriteCompleteDev(
  [in]             PFILE_OBJECT   FileObject,
  [in]             PLARGE_INTEGER FileOffset,
  [in]             PMDL           MdlChain,
  [ in, optional ] PDEVICE_OBJECT DeviceObject
);

Parâmetros

[in] FileObject

Um ponteiro para o objeto de arquivo.

[in] FileOffset

Um ponteiro para um valor que especifica o deslocamento de bytes inicial dentro do cache que contém os dados.

[in] MdlChain

Um ponteiro para uma lista vinculada de MDLs (listas de descritores de memória) que FsRtlPrepareMdlWriteDev alocado.

[ in, optional ] DeviceObject

Um ponteiro para um objeto de dispositivo no qual o arquivo é aberto.

Valor de retorno

A rotina FsRtlMdlWriteCompleteDev retornará verdadeiro se a operação for bem-sucedida e false se a operação falhar ou se o sinalizador FO_WRITE_THROUGH estiver definido no objeto de arquivo.

Observações

A rotina FsRtlMdlWriteCompleteDev libera as listas de descritores de memória (MDLs) que FsRtlPrepareMdlWriteDev alocadas e desbloqueia a memória de cache que FsRtlPrepareMdlWriteDev bloqueado.

Se o sinalizador FO_WRITE_THROUGH estiver definido no objeto de arquivo apontado pelo parâmetro FileObject, FsRtlMdlWriteCompleteDev liberará imediatamente a memória armazenada em cache para o disco. Essa operação de liberação reentra no sistema de arquivos e pode fazer com que FsRtlMdlWriteCompleteDev crie uma exceção se a operação de liberação falhar.

Cada chamada para FsRtlPrepareMdlWriteDev deve ser seguida por uma chamada para FsRtlMdlWriteCompleteDev.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 8.
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte também

FsRtlPrepareMdlWriteDev

Compartilhar via