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）。
[out] IoStatus
輸出中 IO_STATUS_BLOCK 結構的指標，其中包含傳輸的狀態。 如果作業成功，IoStatus.Status 設定為 STATUS_SUCCESS。 否則，它會設定為適當的NTSTATUS錯誤碼。 IoStatus.Information 設定為例程成功鎖定的實際位元組數目。
傳回值
FsRtlMdlReadEx 會傳回 STATUS_SUCCESS 或適當的 NTSTATUS 值，例如下列其中一項：
| 傳回碼 | 描述 |
|---|---|
| STATUS_INSUFFICIENT_RESOURCES | 無法配置 IRP 型讀取的 IRP。 |
言論
如果可從文件系統取得快速 I/O，則呼叫端可用來直接存取快取檔案數據的 FsRtlMdlReadEx 例程會略過一般的 IRP 讀取機制，並傳回記憶體描述元列表的連結清單 （MDL）。 此作業不會複製或緩衝數據，因此比一般讀取快得多。 如果未啟用快速 I/O，FsRtlMdlReadEx 會產生同步 IRP 型 MDL 讀取，並從要求傳回 MDL。
MDL 所描述的頁面會鎖定在記憶體中，但不會在系統空間中對應。 呼叫端可以呼叫 MmGetSystemAddressForMdlSafe來執行此對應。
與 CcMdlRead類似，FsRtlMdlReadEx 例程會鎖定包含快取檔案數據的頁面，以防止系統將這些頁面交換至頁面檔案。 在呼叫端叫用 CcMdlReadComplete 例程
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 目標平臺 | 普遍 |
| 標頭 | ntifs.h （include Ntifs.h） |
| 連結庫 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |