MmAllocateContiguousMemory 函式 (wdm.h)

發行項
02/27/2024

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

語法

PVOID MmAllocateContiguousMemory(
  [in] SIZE_T           NumberOfBytes,
  [in] PHYSICAL_ADDRESS HighestAcceptableAddress
);

參數

[in] NumberOfBytes

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

[in] HighestAcceptableAddress

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

傳回值

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

備註

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

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

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

當不再需要記憶體時，必須釋放 MmAllocateContiguousMemory 配置的記憶體。呼叫 MmFreeContiguousMemory 例程來釋放 MmAllocateContiguousMemory 所配置的記憶體。

當實體記憶體分散在具有大量 RAM 的電腦上時，呼叫 MmAllocateContiguousMemory 需要操作系統搜尋連續記憶體區塊時，可能會嚴重降低效能。從 Windows Vista SP1 和 Windows Server 2008 開始，這項降低大幅降低，但連續記憶體仍可能很昂貴。因此，驅動程式應該避免重複呼叫 MmAllocateContiguousMemory。相反地，驅動程式應該在其 DriverEntry 例程中配置所有必要的連續緩衝區，並重複使用這些緩衝區。

MmAllocateContiguousMemory 配置的記憶體未初始化。核心模式驅動程式必須先將此記憶體設定為零，如果使用者模式軟體 (才能看見，以避免) 外泄潛在的特殊許可權內容。