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 開始提供。 |
| 目標平台 | Universal |
| 標頭 | ntddk.h (包含 Wdm.h、Ntddk.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | IRQL <= DISPATCH_LEVEL |