Edit

Share via

FltFastIoMdlWriteComplete function (fltkernel.h)

  • Article

The FltFastIoMdlWriteComplete routine frees the resources that FltFastIoPrepareMdlWrite allocated.

Syntax

BOOLEAN FLTAPI FltFastIoMdlWriteComplete(
       PFLT_INSTANCE  InitiatingInstance,
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] PMDL           MdlChain
);

Parameters

InitiatingInstance

Opaque instance pointer for the caller. This parameter is required and cannot be NULL.

[in] FileObject

A pointer to the file object.

[in] FileOffset

A pointer to a value that specifies the starting byte offset within the cache that holds the data.

[in] MdlChain

A pointer to a linked list of memory descriptor lists (MDLs) that FltFastIoPrepareMdlWrite allocated.

Return value

The FltFastIoMdlWriteComplete routine returns TRUE if the operation succeeds and FALSE if the operation fails or if the FO_WRITE_THROUGH flag is set in the file object.

Remarks

The FltFastIoMdlWriteComplete routine frees the memory descriptor lists (MDLs) that FltFastIoPrepareMdlWrite allocated and unlocks the cache memory that FltFastIoPrepareMdlWrite locked.

If the FO_WRITE_THROUGH flag is set on the file object pointed to by the FileObject parameter, FltFastIoMdlWriteComplete immediately flushes the cached memory to disk. This flush operation re-enters the file system and can cause FltFastIoMdlWriteComplete to raise an exception if the flush operation fails.

Each call to FltFastIoPrepareMdlWrite must be followed by a call to FltFastIoMdlWriteComplete.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 8.
Target Platform Universal
Header fltkernel.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

See also

FltFastIoPrepareMdlWrite