VirtualAlloc 函式 (memoryapi.h)

  • 發行項

在呼叫程式的虛擬位址空間中保留、認可或變更頁面區域的狀態。 此函式配置的記憶體會自動初始化為零。

若要在另一個進程的位址空間中配置記憶體，請使用 VirtualAllocEx 函 式。

語法

LPVOID VirtualAlloc(
  [in, optional] LPVOID lpAddress,
  [in]           SIZE_T dwSize,
  [in]           DWORD  flAllocationType,
  [in]           DWORD  flProtect
);

參數

[in, optional] lpAddress

要配置之區域的起始位址。 如果保留記憶體，指定的位址會四捨五入到配置粒度的最接近倍數。 如果記憶體已保留且正在認可，位址會捨入到下一個頁面界限。 若要判斷頁面大小和主計算機上的配置粒度，請使用 GetSystemInfo 函式。 如果此參數為 NULL，系統會決定要配置區域的位置。

如果這個位址位於您尚未呼叫 InitializeEnclave 來初始化的記憶體保護區內， VirtualAlloc 會為該位址的記憶體保護區配置零頁。 頁面必須先前未認可，且不會使用 Intel Software Guard Extensions 程式設計模型的 EEXTEND 指令來測量。

如果位址位於您初始化的記憶體保護區內，則配置作業會失敗，並出現 ERROR_INVALID_ADDRESS 錯誤。 這適用於不支援動態記憶體管理 (的記憶體保護區，也就是SGX1) 。 SGX2 記憶體保護區將允許配置，且配置后，記憶體保護區必須接受該頁面。

[in] dwSize

區域的大小，以位元組為單位。 如果 lpAddress 參數為 NULL，這個值會四捨五入至下一個頁面界限。 否則，配置的頁面會包含範圍中包含一或多個字節的所有頁面，從 lpAddress 到 lpAddress+dwSize。 這表示 2 位元組的範圍跨越頁面界限會導致這兩個頁面都包含在配置的區域中。

[in] flAllocationType

記憶體配置的類型。 此參數必須包含下列其中一個值。

值 意義
MEM_COMMIT
0x00001000
 針對指定的保留記憶體頁面，配置記憶體費用 (磁碟上的整體大小和分頁檔案) 。 函式也保證當呼叫端稍後一開始存取記憶體時，內容會是零。 除非實際存取虛擬位址，否則不會配置實際的實體頁面。

若要在一個步驟中保留和認可頁面，請使用 呼叫 VirtualAllocMEM_COMMIT | MEM_RESERVE。

除非已保留整個範圍，否則嘗試藉由指定沒有MEM_RESERVE的MEM_COMMIT來認可特定位址範圍，且非 NULLlpAddress 會失敗。 產生的錯誤碼 ERROR_INVALID_ADDRESS。

嘗試認可已認可的頁面，並不會使函式失敗。 這表示您可以認可頁面，而不需要先判斷每個頁面的目前承諾用量狀態。

如果 lpAddress 指定記憶體保護區內的位址，則必須MEM_COMMITflAllocationType。
MEM_RESERVE
0x00002000
 保留進程的虛擬位址空間範圍，而不需在記憶體或磁碟上的分頁檔案中配置任何實際的實體記憶體。

您可以在後續呼叫 VirtualAlloc 函式時認可保留頁面。 若要在一個步驟中保留並認可頁面，請使用 MEM_COMMIT | MEM_RESERVE 呼叫 VirtualAlloc。

其他記憶體配置函式，例如 malloc 和 LocalAlloc，在釋放記憶體之前，無法使用保留的記憶體範圍。
MEM_RESET
0x00080000
 指出 lpAddress 和 dwSize 所指定的記憶體範圍中的數據已不再感興趣。 頁面不應該讀取或寫入至分頁檔案。 不過，稍後會再次使用記憶體區塊，因此不應予以認可。 這個值不能與任何其他值搭配使用。

使用這個值不保證以 MEM_RESET 運作的範圍將包含零。 如果您想要範圍包含零，請取消認可記憶體，然後重新認可。

當您指定 MEM_RESET時， VirtualAlloc 函式會忽略 flProtect 的值。 不過，您仍然必須將 flProtect 設定為有效的保護值，例如 PAGE_NOACCESS。

如果您使用 MEM_RESET，且記憶體範圍對應至檔案，VirtualAlloc 會傳回錯誤。 只有在共享檢視對應至分頁檔案時才可接受。
MEM_RESET_UNDO
0x1000000
 MEM_RESET_UNDO 應該只在先前成功套用 MEM_RESET 的位址範圍上呼叫。 它表示 lpAddress 和 dwSize 所指定記憶體範圍中的數據對呼叫端感興趣，並嘗試反轉 MEM_RESET的效果。 如果函式成功，這表示指定位址範圍中的所有數據都保持不變。 如果函式失敗，位址範圍中的部分數據至少已取代為零。

這個值不能與任何其他值搭配使用。 如果在先前未MEM_RESET的位址範圍上呼叫MEM_RESET_UNDO，則行為是未定義的。 當您指定 MEM_RESET時， VirtualAlloc 函式會忽略 flProtect 的值。 不過，您仍然必須將 flProtect 設定為有效的保護值，例如 PAGE_NOACCESS。

Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： Windows 8 和 Windows Server 2012 之前，不支援 MEM_RESET_UNDO 旗標。

此參數也可以指定下列值，如所述。

值 意義
MEM_LARGE_PAGES
0x20000000
 使用 大型頁面支援來配置記憶體。

大小和對齊必須是大頁最小值的倍數。 若要取得此值，請使用 GetLargePageMinimum 函式。

如果您指定此值，您也必須指定 MEM_RESERVE 和 MEM_COMMIT。
MEM_PHYSICAL
0x00400000
 保留可用來對應 位址視窗延伸 模組的位址範圍， (AWE) 頁面。

此值必須與 MEM_RESERVE 搭配使用，而且沒有其他值。
MEM_TOP_DOWN
0x00100000
 以最高的可能位址配置記憶體。 這可能會比一般配置慢，特別是在有許多配置時。
MEM_WRITE_WATCH
0x00200000
 讓系統追蹤在已配置區域中寫入的頁面。 如果您指定此值，也必須指定 MEM_RESERVE。

若要擷取自配置區域或重設寫入追蹤狀態以來已寫入的頁面位址，請呼叫 GetWriteWatch 函式。 若要重設寫入追蹤狀態，請呼叫 GetWriteWatch 或 ResetWriteWatch。 寫入追蹤功能仍會針對記憶體區域啟用，直到釋放區域為止。

[in] flProtect

要配置之頁面區域的記憶體保護。 如果正在認可頁面，您可以指定任何一個 記憶體保護常數。

如果 lpAddress 指定記憶體保護區內的位址， flProtect 不能是下列任何值：

  • PAGE_NOACCESS
  • PAGE_GUARD
  • PAGE_NOCACHE
  • PAGE_WRITECOMBINE

配置記憶體保護區的易失記憶體時， flProtect 參數必須 PAGE_READWRITE 或 PAGE_EXECUTE_READWRITE。

傳回值

如果函式成功，傳回值就是分頁配置區域的基位址。

如果函式失敗，傳回值為 NULL。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

每個頁面都有相關聯的 頁面狀態。 VirtualAlloc 函式可以執行下列作業：

  • 認可保留頁面的區域
  • 保留免費頁面的區域
  • 同時保留並認可免費頁面的區域

VirtualAlloc 無法保留保留頁面。 它可以認可已經認可的頁面。 這表示不論頁面是否已認可，您都可以認可一系列頁面，而且函式不會失敗。

您可以使用 VirtualAlloc 來保留頁面區塊，然後對 VirtualAlloc 進行其他呼叫，以認可保留區塊中的個別頁面。 這可讓進程保留其虛擬位址空間的範圍，而不需要耗用實體記憶體，直到需要為止。

如果 lpAddress 參數不是 NULL，函式會使用 lpAddress 和 dwSize 參數來計算要配置的頁面區域。 整個頁面範圍的目前狀態必須與 flAllocationType 參數所指定的配置類型相容。 否則，函式會失敗，而且不會配置任何頁面。 此相容性需求不會排除認可已認可的頁面，如先前所述。

若要執行動態產生的程式代碼，請使用 VirtualAlloc 配置記憶體和 VirtualProtect 函式來授 與PAGE_EXECUTE 存取權。

VirtualAlloc 函式可用來在指定進程的虛擬位址空間內保留位址視窗延伸模組 (AWE) 記憶體區域。 然後，您可以使用此記憶體區域，將實體頁面對應至應用程式所需的虛擬記憶體和虛擬記憶體外。 必須在 AllocationType 參數中設定MEM_PHYSICAL和MEM_RESERVE值。 不得設定 MEM_COMMIT 值。 頁面保護必須設定為 PAGE_READWRITE。

VirtualFree 函式可以取消認可頁面、釋放頁面的記憶體，也可以同時解除認可並釋放認可的頁面。 它也可以釋放保留頁面，使其成為免費頁面。

建立將可執行的區域時，呼叫程式會負責在程式代碼設定完成之後，透過適當的 FlushInstructionCache 呼叫來確保快取一致性。 否則，嘗試從新可執行區域執行程序代碼可能會產生無法預期的結果。

範例

如需範例，請參閱 保留和認可記憶體。

規格需求

   
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 memoryapi.h (包括 Windows.h、Memoryapi.h)
程式庫 onecore.lib
DLL Kernel32.dll

另請參閱

記憶體管理功能

虛擬記憶體函式

VirtualAllocEx

VirtualFree

VirtualLock

VirtualProtect

VirtualQuery

VBS 記憶體保護區中可用的 Vertdll API