MmFreeContiguousMemory 函式 (wdm.h)

MmFreeContiguousMemory 例程會釋放 MmAllocateContiguousMemoryXxx 例程所配置的實體連續記憶體範圍。

語法

void MmFreeContiguousMemory(
  [in] PVOID BaseAddress
);

參數

[in] BaseAddress

要釋放之內存虛擬位址的指標。

傳回值

備註

MmFreeContiguousMemory 例程會釋放先前呼叫 MmAllocateContiguousMemory、MmAllocateContiguousMemoryMmAllocateContiguousMemorySpecifyCache 或 MmAllocateContiguousMemorySpecifyCacheNode 例程所配置的實體連續記憶體區塊。 BaseAddress 參數必須是從先前呼叫 MmAllocateContiguousMemoryXxx 例程取得的基位址。

必須使用連續記憶體的裝置驅動程序應該只配置驅動程式初始化期間所需的專案,因為實體記憶體可能會隨著系統執行而分散。 當驅動程式使用記憶體完成時,這類驅動程式必須解除分配記憶體。

MmFreeContiguousMemory 的呼叫端必須在 IRQL = APC_LEVEL上執行。 針對 Windows Server 2008 和更新版本的 Windows 操作系統,您也可以使用 IRQL <= DISPATCH_LEVEL呼叫 MmFreeContiguousMemory。 不過,您可以藉由在 APC_LEVEL 或以下呼叫 來改善驅動程式效能。

規格需求

需求
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL 請參閱一節。
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) IrqlMmDispatch (wdm)

另請參閱

MmAllocateContiguousMemory

MmAllocateContiguousMemorySpecifyCache

MmAllocateContiguousMemorySpecifyCacheNode