FsRtlMdlReadEx 函式 (ntifs.h)

  • 發行項

FsRtlMdlReadEx 例程會執行快速快取的 MDL 讀取。 如果未快取要求的數據，例程會還原為以 IRP 為基礎的 MDL 讀取作業。

語法

NTSTATUS FsRtlMdlReadEx(
  [in]  PFILE_OBJECT     FileObject,
  [in]  PLARGE_INTEGER   FileOffset,
  [in]  ULONG            Length,
  [in]  ULONG            LockKey,
  [out] PMDL             *MdlChain,
  [out] PIO_STATUS_BLOCK IoStatus
);

參數

[in] FileObject

檔案物件的指標。

[in] FileOffset

變數的指標，指定保留數據的快取檔案內的起始位移。

[in] Length

要從快取讀取之數據的位元組長度。

[in] LockKey

值，與要鎖定的位元組範圍相關聯。 如果鎖定的範圍重疊另一個已鎖定為非例外鎖定的範圍，或要讀取的範圍是另一個範圍子範圍，且該範圍已非永久鎖定，則此參數中的值必須是該非例外鎖定的索引鍵。鎖定必須由呼叫線程的父進程保留。 否則，此參數不會有任何作用。

[out] MdlChain

接收記憶體描述元清單連結清單指標的變數位址， (MDL) 。 MdlChain 必須先初始化為 NULL ， 才能呼叫 FsRtlMdlReadEx。

[out] IoStatus

輸出上IO_STATUS_BLOCK結構的指標，其中包含傳輸的狀態。 如果作業成功， IoStatus.Status 會設定為 STATUS_SUCCESS。 否則，它會設定為適當的NTSTATUS錯誤碼。 IoStatus.Information 會設定為例程成功鎖定的實際位元組數目。

傳回值

FsRtlMdlReadEx 會 傳回STATUS_SUCCESS 或適當的 NTSTATUS 值，例如下列其中一項：

傳回碼 Description
STATUS_INSUFFICIENT_RESOURCES 無法配置 IRP 型讀取的 IRP。

備註

如果文件系統提供快速 I/ O，FsRtlMdlReadEx 例程將會略過一般的 IRP 讀取機制，並傳回記憶體描述元清單的連結清單， (MDL) 呼叫者可用來直接存取快取的檔案數據。 這項作業不會複製或緩衝數據，因此比一般讀取更快。 如果未啟用快速 I/ O，FsRtlMdlReadEx 會產生以同步 IRP 為基礎的 MDL 讀取，並從要求傳回 MDL。

MDL 所描述的頁面會鎖定在記憶體中，但未對應到系統空間中。 呼叫端可以呼叫 MmGetSystemAddressForMdlSafe 來執行此對應。

與 CcMdlRead 類似， FsRtlMdlReadEx 例程會鎖定包含快取檔案數據的頁面，以防止系統將這些頁面交換至頁面檔案。 在呼叫端叫用 CcMdlReadComplete 例程之前，頁面會保持鎖定在記憶體中。

規格需求

需求 值
最低支援的用戶端 Windows 8
目標平台 Universal
標頭 ntifs.h (包含 Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL

另請參閱

CcMdlRead

CcMdlReadComplete

IO_STATUS_BLOCK

MmGetSystemAddressForMdlSafe