MmAllocateContiguousMemory 函式 （ntddk.h）
MmAllocateContiguousMemory 例程會配置一系列連續、非分頁的實體記憶體，並將其對應至系統地址空間。
語法
PVOID MmAllocateContiguousMemory(
[in] SIZE_T NumberOfBytes,
[in] PHYSICAL_ADDRESS HighestAcceptableAddress
);
參數
[in] NumberOfBytes
要配置的連續記憶體區塊大小，以位元組為單位。 如需詳細資訊，請參閱。
[in] HighestAcceptableAddress
呼叫端可以使用的最高有效實體位址。 例如，如果裝置只能尋址處理器物理記憶體位址範圍前 16 MB 的位置，則此裝置的驅動程式應該將 highestAcceptableAddress 設定為 0x0000000000FFFFFF。
傳回值
mmAllocateContiguousMemory 會傳回配置記憶體的基底虛擬位址。 如果無法滿足要求，例程會傳回 NULL。
言論
MmAllocateContiguousMemory 配置實體位址空間中連續的非分頁記憶體區塊。 例程會將此區塊對應至系統位址空間中連續的虛擬記憶體區塊，並傳回此區塊基底的虛擬位址。 例程會將連續記憶體配置的起始位址對齊記憶體分頁界限。
驅動程式不得存取超過要求配置大小的記憶體。 例如，開發人員不應該假設其驅動程式可以在要求配置結尾和下一頁界限之間安全地使用記憶體。
由於連續的物理記憶體通常供不應求，因此應該謹慎使用，而且只在必要時使用。 在驅動程式初始化期間，必須使用連續記憶體的驅動程序應該配置此記憶體，因為當作系統配置和釋放記憶體時，實體記憶體可能會隨著時間而分散。 一般而言，驅動程式會從其 DriverEntry 例程呼叫 MmAllocateContiguousMemory，以配置內部緩衝區以供長期使用，並在卸除驅動程式之前釋放緩衝區。
不再需要記憶體時，必須釋放由 MmAllocateContiguousMemory 配置的記憶體。 呼叫 MmFreeContiguousMemory 例程，以釋放由 MmAllocateContiguousMemory所配置的記憶體。
當物理記憶體分散在具有大量 RAM 的電腦上時，呼叫 MmAllocateContiguousMemory，這需要作系統搜尋連續的記憶體區塊，可能會嚴重降低效能。 從 Windows Vista SP1 和 Windows Server 2008 開始，這種降低會大幅降低，但連續記憶體仍會耗費大量資源來配置。 因此，驅動程式應避免重複呼叫 mmAllocateContiguousMemory。 相反地，驅動程式應該在其 DriverEntry 例程中配置所有必要的連續緩衝區，並重複使用這些緩衝區。
MmAllocateContiguousMemory 配置的記憶體未初始化。 如果核心模式驅動程式要讓使用者模式軟體看到記憶體，必須先將此記憶體設定為零（以避免洩漏潛在的特殊許可權內容）。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平臺 | 普遍 |
| 標頭 | ntddk.h （include Wdm.h， Ntddk.h） |
| 連結庫 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | IRQL <= DISPATCH_LEVEL |