VirtualAllocEx 函式 （memoryapi.h）

保留、認可或變更指定進程虛擬位址空間記憶體區域的狀態。 函式會初始化它配置給零的記憶體。

若要指定實體記憶體的 NUMA 節點，請參閱 virtualAllocExNuma。

語法

LPVOID VirtualAllocEx(
  [in]           HANDLE hProcess,
  [in, optional] LPVOID lpAddress,
  [in]           SIZE_T dwSize,
  [in]           DWORD  flAllocationType,
  [in]           DWORD  flProtect
);

參數

[in] hProcess

進程的句柄。 函式會在此進程的虛擬位址空間內配置記憶體。

句柄必須具有 PROCESS_VM_OPERATION 訪問許可權。 如需詳細資訊，請參閱 處理安全性和存取權限。

[in, optional] lpAddress

指標，指定您要配置之頁面區域的所需起始位址。

如果您要保留記憶體，函式會將此位址捨入到最接近的配置粒度倍數。

如果您要認可已保留的記憶體，函式會將這個位址捨入到最接近的頁面界限。 若要判斷頁面的大小和主計算機上的配置粒度，請使用 getSystemInfo 函式 。

如果 lpAddressNULL，函式會決定配置區域的位置。

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

如果您初始化的記憶體保護區內的位址，則配置作業會失敗，並出現 ERROR_INVALID_ADDRESS 錯誤。 對於不支援易失記憶體管理的記憶體保護區而言，這是事實（亦即 SGX1）。 SGX2 記憶體保護區將允許配置，而且頁面必須在配置後由記憶體保護區接受。

[in] dwSize

要配置的記憶體區域大小，以位元組為單位。

如果 lpAddressNULL，則函式會將 dwSize 四捨五入 到下一個頁面界限。

如果 lpAddress 不是 NULL，則函式會將範圍中包含一或多個字節的所有頁面配置 lpAddress，以 lpAddress+dwSize。 例如，這表示跨越頁面界限的 2 位元組範圍會導致函式配置這兩個頁面。

[in] flAllocationType

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

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

[in] flProtect

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

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

• PAGE_NOACCESS
• PAGE_GUARD
• PAGE_NOCACHE
• PAGE_WRITECOMBINE

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

傳回值

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

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

言論

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

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

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

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

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

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

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

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

要求

另請參閱

記憶體管理功能

ReadProcessMemory

虛擬記憶體函式

VirtualAllocExNuma

VirtualFreeEx

VirtualLock

VirtualProtect

VirtualQuery

WriteProcessMemory