FltFastIoMdlWriteComplete function (fltkernel.h)
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 |