VirtualAlloc 関数 (memoryapi.h)

呼び出し元プロセスの仮想アドレス空間内のページ領域の状態を予約、コミット、または変更します。 この関数によって割り当てられたメモリは、自動的に 0 に初期化されます。

別のプロセスのアドレス空間にメモリを割り当てるには、VirtualAllocEx 関数を使用します。

構文

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

パラメーター

[in, optional] lpAddress

割り当てるリージョンの開始アドレス。 メモリが予約されている場合、指定したアドレスは、割り当て粒度の最も近い倍数に切り捨てられます。 メモリが既に予約されていてコミットされている場合、アドレスは次のページ境界に切り捨てられます。 ホスト コンピューター上のページのサイズと割り当ての粒度を決定するには、GetSystemInfo 関数を使用します。 このパラメーターが NULL場合、システムは領域を割り当てる場所を決定します。

このアドレスが InitializeEnclave呼び出して初期化していないエンクレーブ内にある場合、VirtualAlloc は、そのアドレスのエンクレーブに 0 のページを割り当てます。 このページは以前はコミットされていない必要があり、Intel Software Guard Extensions プログラミング モデルの EEXTEND 命令では測定されません。

アドレスが初期化したエンクレーブ内にある場合、割り当て操作は ERROR_INVALID_ADDRESS エラーで失敗します。 これは、動的メモリ管理 (つまり SGX1) をサポートしていないエンクレーブに当てはまります。 SGX2 エンクレーブは割り当てを許可し、ページは割り当てられた後にエンクレーブによって受け入れられる必要があります。

[in] dwSize

リージョンのサイズ (バイト単位)。 lpAddress パラメーターが NULL場合、この値は次のページ境界に切り上げられます。 それ以外の場合、割り当てられたページには、lpAddress から dwSizelpAddress までの範囲の 1 つ以上のバイトを含むすべてのページが含まれます。 つまり、ページ境界にまたがる 2 バイト範囲では、両方のページが割り当てられた領域に含まれます。

[in] flAllocationType

メモリ割り当ての種類。 このパラメーターには、次のいずれかの値が含まれている必要があります。

このパラメーターでは、次の値を指定することもできます。

[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) 領域を予約できます。 その後、このメモリ領域を使用して、アプリケーションの必要に応じて、仮想メモリとの間で物理ページをマップできます。 MEM_PHYSICAL と MEM_RESERVE の値は、AllocationType パラメーターで設定する必要があります。 MEM_COMMIT 値は設定しないでください。 ページ保護を PAGE_READWRITEに設定する必要があります。

VirtualFree 関数は、コミットされたページのコミットを解除したり、ページのストレージを解放したり、コミットされたページを同時にデコミットして解放したりできます。 また、予約ページを解放して、無料のページにすることもできます。

実行可能なリージョンを作成する場合、呼び出し元のプログラムは、コードが設定されたら、FlushInstructionCache への適切な呼び出しによってキャッシュの一貫性を確保する責任を負います。 そうしないと、新しく実行可能なリージョンからコードを実行しようとすると、予期しない結果が発生する可能性があります。

例

例については、「メモリの予約とコミット」を参照してください。

必要条件

関連項目

メモリ管理機能の

仮想メモリ関数 の

VirtualAllocEx の

VirtualFree

VirtualLock

VirtualProtect

VirtualQuery の

VBS エンクレーブ で使用できる Vertdll API