共用方式為


MmMapLockedPagesWithReservedMapping 函式 (wdm.h)

MmMapLockedPagesWithReservedMapping 例程會對應所有或部分先前由 MmAllocateMappingAddress 例程保留的地址範圍。

語法

PVOID MmMapLockedPagesWithReservedMapping(
  [in] PVOID                                                    MappingAddress,
  [in] ULONG                                                    PoolTag,
  [in] PMDL                                                     MemoryDescriptorList,
  [in] __drv_strictTypeMatch(__drv_typeCond)MEMORY_CACHING_TYPE CacheType
);

參數

[in] MappingAddress

保留虛擬記憶體範圍的開頭指標。 這必須是 MmAllocateMappingAddress 先前傳回的位址。

[in] PoolTag

指定保留記憶體緩衝區的集區標籤。 這必須與呼叫保留緩衝區之 MmAllocateMappingAddressPoolTag 參數中指定的值相同。

[in] MemoryDescriptorList

要對應的 MDL 指標。 此 MDL 必須描述鎖定的實體頁面。 鎖定的 MDL 可由 MmProbeAndLockPagesMmAllocatePagesForMdlEx 例程所建置。

[in] CacheType

指定要用來建立對應的 MEMORY_CACHING_TYPE 值。

傳回值

MmMapLockedPagesWithReservedMapping 會傳回對應記憶體開頭的指標,如果系統無法對應記憶體,則傳回 NULL 。 只有當函式參數 (發生錯誤時,此例程才會傳回 NULL ,例如驅動程式的對應位址不足以跨越提供的 MDL) 。 此函式旨在讓驅動程式即使在低資源案例中也能向前進行。

備註

呼叫端可以使用 MmMapLockedPagesWithReservedMapping 來對應 MmAllocateMappingAddress 所保留之虛擬記憶體範圍的子範圍,如下所示:

  • 使用 IoAllocateMdl 來配置 MDL。 傳回的 MDL 是使用要對應的虛擬記憶體範圍的指定起始位址和大小來建置。

  • 使用 MmProbeAndLockPages 鎖定步驟 1 中取得之 MDL 所描述的實體頁面。

  • 使用 MmMapLockedPagesWithReservedMapping 實際將虛擬記憶體對應至步驟 2 中鎖定的實體記憶體。 請注意,此函式所傳回的虛擬位址確實包含 MDL 指定的位元移。 不過,此函式所設定之 MDL 的 MappedSystemVa 欄位不包含位元組位移。

  • 呼叫端不需要存取記憶體之後,它會使用 MmUnmapReservedMapping 取消對應記憶體。 呼叫端可以視需要對應和取消對應記憶體緩衝區,而且必須先取消對應,才能使用 MmFreeMappingAddress 釋放對應範圍。

請注意, MappingAddress 參數會指定呼叫端先前保留的記憶體範圍的開頭,而不是要對應的記憶體子範圍開頭。 呼叫端會在使用 IoAllocateMdl配置 MDL 時,指定緩衝區的起始位址和長度。 緩衝區必須符合保留的記憶體範圍,但可以是嚴格的子集。

只有在 MDL 所描述的頁面還沒有與其相關聯的快取類型時,例程才會使用 CacheType 參數。 不過,在幾乎所有情況下,頁面已經有相關聯的快取類型,而且新的對應會使用此快取類型。 此規則的例外狀況是 MmAllocatePagesForMdl 所配置的頁面,這些頁面沒有相關聯的特定快取類型。 對於這類頁面, CacheType 參數會決定對應的快取類型。

規格需求

需求
最低支援的用戶端 可在 Windows XP 和更新版本的 Windows 中使用。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIS (storport)

另請參閱

IoAllocateMdl

MEMORY_CACHING_TYPE

MmAllocateMappingAddress

MmAllocatePagesForMdl

MmAllocatePagesForMdlEx

MmFreeMappingAddress

MmProbeAndLockPages

MmUnmapReservedMapping