Função FsRtlMdlWriteCompleteDev (ntifs.h)

A rotina FsRtlMdlWriteCompleteDev libera os recursos alocados por FsRtlPrepareMdlWriteDev .

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) alocadas por FsRtlPrepareMdlWriteDev .

[ in, optional ] DeviceObject

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

Retornar valor

A rotina FsRtlMdlWriteCompleteDev retornará TRUE 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.

Comentários

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

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 no disco. Essa operação de liberação entra novamente no sistema de arquivos e pode fazer com que FsRtlMdlWriteCompleteDev gere 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
Cliente mínimo com suporte Disponível a partir do Windows 8.
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Confira também

FsRtlPrepareMdlWriteDev