MapUserPhysicalPages

以前に確保された物理メモリページを、Address Windowing Extensions (AWE) 領域内の指定アドレスにマップする。(MapUserPhysicalPages)

MapUserPhysicalPages VirtualAddress, NumberOfPages, PageArray

VirtualAddress : [intptr] 再マップするメモリ領域の先頭アドレスへのポインタ。lpAddress の値は、Address Windowing Extensions (AWE) 領域が確保されたときに VirtualAlloc 関数が返すアドレス範囲内になければならない。
NumberOfPages : [int] 変換を確立する物理メモリおよび仮想アドレス空間のサイズ（ページ単位）。仮想アドレス範囲は lpAddress から始まる連続領域である。物理フレームは UserPfnArray で指定する。合計ページ数は、AllocateUserPhysicalPages で指定された範囲の末尾を、開始アドレスから超えてはならない。
PageArray : [var] 物理ページフレーム番号の配列へのポインタ。これらのフレームは、この関数からの戻り時に引数 lpAddress によってマップされる。確保されるメモリのサイズは、少なくとも NumberOfPages にデータ型 ULONG_PTR のサイズを掛けた値でなければならない。

(プラグイン / モジュール : kernel32.dll)

解説

以前に確保された物理メモリページを、Address Windowing Extensions (AWE)
領域内の指定アドレスにマップする。(MapUserPhysicalPages)

[戻り値]
関数が成功した場合、戻り値は TRUE である。関数が失敗した場合、戻り値は FALSE
で、部分的にもマッピングは行われない。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
物理ページのマップは解除されるが解放されない。物理ページを解放するには FreeUserPhysicalPages
を呼ばなければならない。任意の枚数の物理メモリページを指定できるが、メモリは VirtualAlloc
が確保する仮想アドレス空間の外に及んではならない。既存のアドレスマップは新しい変換によって自動的に上書きされ、古い変換はマップ解除される。AllocateUserPhysicalPages
で指定された範囲外の物理メモリページをマップすることはできない。複数の領域を同時にマップできるが、それらは重なってはならない。物理ページは任意の物理アドレスに配置できるが、物理ページの連続性を前提としてはならない。現在のアドレス範囲のマップを解除するには、物理メモリページ配列引数に
NULL を指定する。現在マップされているページはすべて解除されるが、解放はされない。物理ページを解放するには
FreeUserPhysicalPages
を呼ばなければならない。マルチプロセッサ環境では、この関数はハードウェア変換バッファの整合性を維持する。この関数からの戻り時には、すべてのプロセッサのすべてのスレッドが正しいマッピングを見ることが保証される。この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT
マクロを 0x0500 以上に定義する。詳細は「Windows ヘッダの使用」を参照。

情報