MapUserPhysicalPagesScatter

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

MapUserPhysicalPagesScatter VirtualAddresses, NumberOfPages, PageArray

VirtualAddresses : [var] 再マップするメモリ領域の先頭アドレス配列へのポインタ。VirtualAddresses 内の各エントリは、Address Windowing Extensions (AWE) 領域が確保されたときに VirtualAlloc 関数が返すアドレス範囲内になければならない。NumberOfPages の値が配列のサイズを示す。エントリは複数の Address Windowing Extensions (AWE) 領域に属してもよい。
NumberOfPages : [int] 変換を確立する物理メモリおよび仮想アドレス空間のサイズ（ページ単位）。VirtualAddresses の配列が仮想アドレス範囲を指定する。
PageArray : [var] VirtualAddresses 内の対応するページをどう扱うかを示す値の配列へのポインタ。0 は VirtualAddresses 内の対応するエントリのマップを解除することを示し、0 以外の値はそれをマップすることを示す。

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

解説

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

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

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

情報