VirtualAllocExNuma 関数 (memoryapi.h)

  • [アーティクル]

指定したプロセスの仮想アドレス空間内のメモリ領域の状態を予約、コミット、または変更し、物理メモリの NUMA ノードを指定します。

構文

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

パラメーター

[in] hProcess

プロセスへのハンドル。 関数は、このプロセスの仮想アドレス空間内にメモリを割り当てます。

ハンドルには、 PROCESS_VM_OPERATION アクセス権が必要です。 詳細については、「 セキュリティとアクセス権の処理」を参照してください。

[in, optional] lpAddress

割り当てるページの領域に必要な開始アドレスを指定するポインター。

メモリを予約する場合、関数はこのアドレスを割り当て粒度の最も近い倍数に切り捨てる。

既に予約されているメモリをコミットしている場合、関数はこのアドレスを最も近いページ境界に切り捨てます。 ホスト コンピューター上のページのサイズと割り当ての粒度を確認するには、 GetSystemInfo 関数を使用します。

lpAddress が NULL の場合、関数はリージョンを割り当てる場所を決定します。

[in] dwSize

割り当てられるメモリ領域のサイズ (バイト単位)。

lpAddress が NULL の場合、関数は dwSize を次のページ境界に切り上げます。

lpAddress が NULL でない場合、関数は lpAddress から の範囲内の 1 つ以上のバイトを含むすべてのページを(lpAddress+dwSize)割り当てます。 つまり、たとえば、ページ境界をまたぐ 2 バイト範囲の場合、関数は両方のページを割り当てます。

[in] flAllocationType

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

値 説明
MEM_COMMIT
0x00001000
 指定した予約済みメモリ ページに対して (メモリの全体的なサイズとディスク上のページング ファイルから) メモリ料金を割り当てます。 関数は、呼び出し元が後で最初にメモリにアクセスするときに、内容がゼロになることも保証します。 仮想アドレスが実際にアクセスされるまで、実際の物理ページは割り当てされません。

ページを 1 つのステップで予約してコミットするには、 を使用 MEM_COMMIT | MEM_RESERVEして 関数を呼び出します。

MEM_RESERVEを指定せずにMEM_COMMITを指定して特定のアドレス範囲をコミットしようとすると、範囲全体が既に予約されていない限り、NULL 以外の lpAddress が失敗します。 結果のエラー コードは ERROR_INVALID_ADDRESS。

既にコミットされているページをコミットしようとしても、関数は失敗しません。 つまり、各ページの現在のコミットメント状態を最初に判断しなくても、ページをコミットできます。
MEM_RESERVE
0x00002000
 メモリまたはディスク上のページング ファイルに実際の物理ストレージを割り当てずに、プロセスの仮想アドレス空間の範囲を予約します。

予約済みページをコミットするには、 MEM_COMMITを使用して関数をもう一度呼び出します。 ページを 1 つのステップで予約してコミットするには、 を使用 MEM_COMMIT | MEM_RESERVEして 関数を呼び出します。

malloc や LocalAlloc などの他のメモリ割り当て関数では、解放されるまで予約済みメモリを使用できません。
MEM_RESET
0x00080000
 lpAddress および dwSize で指定されたメモリ範囲内のデータが関心を持たなくなったことを示します。 ページをページング ファイルから読み取ったり、ページング ファイルに書き込んだりしないでください。 ただし、メモリ ブロックは後でもう一度使用されるため、コミットを解除しないでください。 この値を他の値と共に使用することはできません。

この値を使用しても、 MEM_RESET で操作される範囲にゼロが含まれるという保証はありません。 範囲にゼロを含める場合は、メモリのコミットを解除してから、再コミットします。

MEM_RESETを使用すると、関数は fProtect の値を無視します。 ただし、 fProtect を有効な保護値 ( PAGE_NOACCESS など) に設定する必要があります。

MEM_RESETを使用し、メモリの範囲がファイルにマップされている場合、関数はエラーを返します。 共有ビューは、ページング ファイルにマップされている場合にのみ使用できます。
MEM_RESET_UNDO
0x1000000
 MEM_RESET_UNDO は、MEM_RESETが以前に正常に 適用されたアドレス 範囲でのみ呼び出す必要があります。 これは、lpAddress および dwSize で指定された指定されたメモリ範囲内のデータが呼び出し元にとって重要であり、MEM_RESETの影響を取り消そうとしていることを示します。 関数が成功した場合、指定されたアドレス範囲のすべてのデータはそのままであることを意味します。 関数が失敗した場合、アドレス範囲のデータの少なくとも一部がゼロに置き換えられました。

この値を他の値と共に使用することはできません。 以前 にMEM_RESET されなかったアドレス範囲で MEM_RESET_UNDO が呼び出された場合、動作は未定義です。 MEM_RESETを指定すると、VirtualAllocExNuma 関数は flProtect の値を無視します。 ただし、 flProtect を有効な保護値 ( PAGE_NOACCESS など) に設定する必要があります。

Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista: MEM_RESET_UNDO フラグは、Windows 8 および Windows Server 2012 までサポートされていません。
 

このパラメーターは、示されているように次の値を指定することもできます。

値 説明
MEM_LARGE_PAGES
0x20000000
 大きなページのサポートを使用してメモリを割り当てます。

サイズと配置は、大きいページの最小値の倍数である必要があります。 この値を取得するには、 GetLargePageMinimum 関数を 使用します。

この値を指定する場合は、 MEM_RESERVE と MEM_COMMITも指定する必要があります。
MEM_PHYSICAL
0x00400000
 アドレス ウィンドウ拡張機能 (AWE) ページのマップに使用できるアドレス範囲を予約します。

この値は 、MEM_RESERVE で使用する必要があり、その他の値は使用できません。
MEM_TOP_DOWN
0x00100000
 可能な限り高いアドレスにメモリを割り当てます。

[in] flProtect

割り当てられるページの領域のメモリ保護。 ページがコミットされている場合は、 メモリ保護定数のいずれかを指定できます。

ページを保護するときに指定された保護属性は、ページの割り当て時に指定された保護属性と競合することはできません。

[in] nndPreferred

物理メモリが存在する必要がある NUMA ノード。

新しい VA リージョン (コミット済みまたは予約済み) を割り当てる場合にのみ使用されます。 それ以外の場合、API を使用して既に存在するリージョン内のページをコミットする場合、このパラメーターは無視されます。

戻り値

関数が成功した場合、戻り値はページの割り当てられた領域のベース アドレスです。

関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

各ページには、関連付けられた ページの状態があります。 VirtualAllocExNuma 関数は、次の操作を実行できます。

  • 予約ページのリージョンをコミットする
  • 無料ページのリージョンを予約する
  • 無料ページの領域を同時に予約してコミットする

VirtualAllocExNuma は予約ページを予約できません。 既にコミットされているページをコミットできます。 つまり、既にコミットされているかどうかに関係なく、ページの範囲をコミットでき、関数は失敗しません。

VirtualAllocExNuma を使用してページブロックを予約し、VirtualAllocExNuma を追加呼び出して予約ブロックから個々のページをコミットできます。 こうすることで、プロセスで必要になるまで物理ストレージを使わずに、仮想アドレス空間の範囲を予約することができます。

lpAddress パラメーターが NULL でない場合、関数は lpAddress パラメーターと dwSize パラメーターを使用して、割り当てられるページの領域を計算します。 ページの範囲全体の現在の状態は、 flAllocationType パラメーターで指定された割り当ての型と互換性がある必要があります。 それ以外の場合、関数は失敗し、どのページも割り当てされません。 この互換性要件は、既にコミットされたページのコミットを妨げるものではありません。上記の一覧を参照してください。

VirtualAllocExNuma は物理ページを割り当てないため、そのノードまたはシステム内の他の場所でページを使用できるかどうかに関係なく成功します。 物理ページはオンデマンドで割り当てられます。 優先ノードがページを使い切った場合、メモリ マネージャーは他のノードのページを使用します。 メモリがページ アウトされている場合は、同じプロセスが取り込まれるときに使用されます。

動的に生成されたコードを実行するには、 VirtualAllocExNuma を使用してメモリを割り当て、 VirtualProtectEx 関数を使用して PAGE_EXECUTEアクセスを 許可します。

VirtualAllocExNuma 関数を使用すると、指定したプロセスの仮想アドレス空間内のメモリのアドレス ウィンドウ拡張機能 (AWE) 領域を予約できます。 その後、このメモリ領域を使用して、アプリケーションで必要に応じて仮想メモリとの間で物理ページをマップできます。 MEM_PHYSICALとMEM_RESERVEの値は、AllocationType パラメーターで設定する必要があります。 MEM_COMMIT値を設定することはできません。 ページ保護は 、PAGE_READWRITEに設定する必要があります。

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

この関数を使用するアプリケーションをコンパイルするには、 _WIN32_WINNTを 0x0600 以降として定義します。

例

例については、「 NUMA ノードからのメモリの割り当て」を参照してください。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー memoryapi.h (Windows.h、Memoryapi.h を含む)
Library onecore.lib
[DLL] Kernel32.dll

関連項目

メモリ管理関数

NUMA サポート

仮想メモリ関数

VirtualAllocEx

VirtualFreeEx

VirtualLock

VirtualProtect

VirtualQuery