MmAllocateContiguousNodeMemory 函式（wdm.h）

發行項
02/07/2025

MmAllocateContiguousNodeMemory 例程會配置一系列連續、非分頁的實體記憶體，並將其對應至系統地址空間。

語法

PVOID MmAllocateContiguousNodeMemory(
  [in]           SIZE_T           NumberOfBytes,
  [in]           PHYSICAL_ADDRESS LowestAcceptableAddress,
  [in]           PHYSICAL_ADDRESS HighestAcceptableAddress,
  [in, optional] PHYSICAL_ADDRESS BoundaryAddressMultiple,
  [in]           ULONG            Protect,
  [in]           NODE_REQUIREMENT PreferredNode
);

參數

[in] NumberOfBytes

要配置的連續記憶體區塊大小，以位元組為單位。如需詳細資訊，請參閱。

[in] LowestAcceptableAddress

呼叫端可以使用的最低有效實體位址。例如，如果裝置只能尋址處理器物理記憶體位址範圍前 8 MB 以上的位置，則此裝置的驅動程式應該將 LowestAcceptableAddress 設定為 0x0000000000800000。

[in] HighestAcceptableAddress

呼叫端可以使用的最高有效實體位址。例如，如果裝置只能尋址處理器物理記憶體位址範圍前 16 MB 的位置，則此裝置的驅動程式應該將 highestAcceptableAddress 設定為 0x0000000000FFFFFF。

[in, optional] BoundaryAddressMultiple

配置之緩衝區不可交叉的實體位址倍數。實體位址倍數一定是兩個電源。這個參數是選擇性的，可以指定為零，表示裝置沒有特殊的記憶體界限限制。如需詳細資訊，請參閱。

[in] Protect

旗標位，指定要用於配置記憶體的保護。呼叫端必須在 protect 參數中設定下列旗標位的一個（但不能同時設定兩者）。

旗標位	意義
PAGE_READWRITE	配置讀取/寫入、無執行（NX）記憶體。大部分的呼叫端都應該設定此旗標位。如需詳細資訊，請參閱。
PAGE_EXECUTE_READWRITE	配置可執行的讀取/寫入記憶體。只有當呼叫端需要能夠在配置的記憶體中執行指令時，才應該設定此旗標位。

此外，呼叫端可以在 Protect 參數中設定下列選擇性旗標位的一個（但不能同時設定兩者）。

旗標位	意義
PAGE_NOCACHE	配置非快取記憶體。這個旗標位實際上與呼叫 MmAllocateContiguousMemorySpecifyCache 類似，CacheType 設定為 MmNonCached。
PAGE_WRITECOMBINE	配置寫入合併的記憶體。這個旗標位實際上類似於呼叫 MmAllocateContiguousMemorySpecifyCache，且快取Type 設定為 MmWriteCombined。

如果未指定PAGE_NOCACHE或PAGE_WRITECOMBINE，則會完全快取已配置的記憶體。在此情況下，效果類似於呼叫 MmAllocateContiguousMemorySpecifyCache，並將 CacheType 設定為 MmCached。

[in] PreferredNode

慣用的節點編號。如果多處理器系統包含 N 個節點，則節點數目會從 0 到 N-1。如果呼叫端將 PreferredNode 設定為MM_ANY_NODE_OK，例程會選擇要配置記憶體的來源節點。否則，如果指定的位址範圍中的記憶體無法從慣用節點配置，則例程會傳回 NULL。

傳回值

MmAllocateContiguousNodeMemory 會傳回配置記憶體的基底虛擬位址。如果無法滿足要求，例程會傳回 NULL。

言論

內核模式設備驅動器會呼叫此例程，以配置連續的實體記憶體區塊。呼叫驅動程式可以指定是否針對配置使用無執行（NX）記憶體。在非統一記憶體存取（NUMA）多處理器系統中，呼叫端可以指定要從中配置記憶體的慣用節點。節點是處理器集合，可共用記憶體區域的快速存取權。在非 NUMA 多處理器或單處理器系統中，MmAllocateContiguousNodeMemory 會將所有記憶體視為屬於單一節點，並從這個節點配置記憶體。

MmAllocateContiguousNodeMemory 配置實體位址空間中連續的非分頁記憶體區塊。例程會將此區塊對應至系統位址空間中連續的虛擬記憶體區塊，並傳回此區塊基底的虛擬位址。例程會將連續記憶體配置的起始位址對齊記憶體分頁界限。

驅動程式不得存取超過要求配置大小的記憶體。例如，開發人員不應該假設其驅動程式可以在要求配置結尾和下一頁界限之間安全地使用記憶體。

由於連續的物理記憶體通常供不應求，因此應該謹慎使用，而且只在必要時使用。在驅動程式初始化期間，必須使用連續記憶體的驅動程序應該配置此記憶體，因為當作系統配置和釋放記憶體時，實體記憶體可能會隨著時間而分散。一般而言，驅動程式會從 DriverEntry 例程呼叫 MmAllocateContiguousNodeMemory，以配置內部緩衝區以供長期使用，並在卸除驅動程式之前釋放緩衝區。

不再需要記憶體時，必須釋放由 MmAllocateContiguousNodeMemory 配置的記憶體。呼叫 MmFreeContiguousMemory 例程，以釋放由 MmAllocateContiguousNodeMemory所配置的記憶體。

MmAllocateContiguousNodeMemory 類似於 MmAllocateContiguousMemorySpecifyCacheNode 例程。不同於 MmAllocateContiguousMemorySpecifyCacheNode，MmAllocateContiguousNodeMemory 可用來配置無執行（NX）記憶體。最佳做法是，除非驅動程序明確要求能夠在配置的記憶體中執行指示，否則驅動程式應該配置 NX 記憶體。藉由配置 NX 記憶體，驅動程式可藉由防止惡意軟體在此記憶體中執行指示來改善安全性。 MmAllocateContiguousMemory、MmAllocateContiguousMemorySpecifyCache和 MmAllocateContiguousMemorySpecifyCacheNode 例程一律可執行。

如果您為 BoundaryAddressMultiple 參數指定非零值，配置記憶體區塊的實體地址範圍將不會跨越這個值之整數倍數的位址界限。除非需要非零值才能解決硬體限制，否則驅動程式應將此參數設定為零。例如，如果裝置無法跨 16 MB 的實體界限傳輸數據，驅動程式應該指定此參數的 0x1000000 值，以確保裝置看到的位址不會以 16 MB 的界限四處換行。

MmAllocateContiguousNodeMemory 配置的記憶體未初始化。如果核心模式驅動程式要讓使用者模式軟體看到記憶體，則核心模式驅動程序必須先將這個記憶體設為零（以避免洩漏潛在的特殊許可權內容）。

要求

要求	價值
最低支援的用戶端	從 Windows 8 開始提供。
目標平臺	普遍
標頭	wdm.h （包括 Wdm.h、 Ntddk.h）
連結庫	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL