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

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

[in] MemoryDescriptorList

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

[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 參數會決定對應的快取類型。

規格需求

另請參閱

IoAllocateMdl

MEMORY_CACHING_TYPE

MmAllocateMappingAddress

MmAllocatePagesForMdl

MmAllocatePagesForMdlEx

MmFreeMappingAddress

MmProbeAndLockPages

MmUnmapReservedMapping