FsRtlMdlWriteCompleteDev 函式 (ntifs.h)
FsRtlMdlWriteCompleteDev 例程會釋放 FsRtlPrepareMdlWriteDev 配置的資源。
語法
BOOLEAN FsRtlMdlWriteCompleteDev(
[in] PFILE_OBJECT FileObject,
[in] PLARGE_INTEGER FileOffset,
[in] PMDL MdlChain,
[ in, optional ] PDEVICE_OBJECT DeviceObject
);
參數
[in] FileObject
檔案物件的指標。
[in] FileOffset
值的指標,指定保留數據的快取內起始位元組位移。
[in] MdlChain
記憶體描述項連結清單的指標, (MDLs) FsRtlPrepareMdlWriteDev 配置。
[ in, optional ] DeviceObject
開啟檔案之裝置物件的指標。
傳回值
如果作業成功, FsRtlMdlWriteCompleteDev 例程會傳回 TRUE ;如果作業失敗,或是在檔案對象中設定FO_WRITE_THROUGH旗標,則會傳回 FALSE 。
備註
FsRtlMdlWriteCompleteDev 例程會釋放記憶體描述項清單 (MDLs) FsRtlPrepareMdlWriteDev 配置並解除鎖定 FsRtlPrepareMdlWriteDev 鎖定的快取記憶體。
如果在 FileObject 參數指向的檔案對象上設定FO_WRITE_THROUGH旗標, FsRtlMdlWriteCompleteDev 會立即將快取的記憶體排清到磁碟。 此排清作業會重新進入文件系統,而且如果排清作業失敗,可能會導致 FsRtlMdlWriteCompleteDev 引發例外狀況。
對 FsRtlPrepareMdlWriteDev 的每個呼叫都必須接著呼叫 FsRtlMdlWriteCompleteDev。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 8 開始提供。 |
目標平台 | Universal |
標頭 | ntifs.h (包含 Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm) |