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)

另請參閱

FsRtlPrepareMdlWriteDev