XMemMapPhysicalPagesScatter
物理ページを仮想メモリにマップします。Syntax
Parameters
*VirtualAddressArray _In_型: PVOID ページをマップする仮想アドレスの配列。このパラメーターを
NULL に設定することはできません。XMemMapPhysicalPagesScatter で使用するメモリ アドレス範囲を予約するには、MEM_RESERVE と XMEM_MAPPABLE を指定して XMemVirtualAlloc を使用します。予約された仮想アドレスは、XMemVirtualAlloc の MEM_64K_PAGES オプションを介して 64k ページで作成する必要もあります。
NumberOfPages _In_型: ULONG_PTR PageArray および VirtualAddressArray 内のエントリ数。MEM_64K_PAGES オプションを使用して XMemVirtualAlloc で予約された 64k ページのみサポートされます。 PageArray _In_reads_opt_(NumberOfPages)
型: PULONG_PTR マップする物理ページを表すページ フレーム番号 (PFN) の配列。このパラメーターは
NULL に設定できます。PageArray が NULL に設定されている場合、この関数はアンマップ操作を実行します。配列内の個々のエントリが NULL に設定されている場合、対応する仮想アドレスがアンマップされます。
Return value
型: BOOL マッピングが成功した場合はTRUE を返します。それ以外の場合、マッピング失敗の場合は FALSE。
Remarks
この関数は、VirtualAddressArray と PageArray を、NumberOfPages で指定される同じ長さの並列配列として扱います。VirtualAddressArray の配列要素にある各仮想アドレスは、PageArray に応じてマップまたはアンマップされます:
PageArray内の配列要素が PFN に設定されている場合、VirtualAddressArray内の対応する配列要素にある仮想アドレスは、その PFN にマップされます。PageArray内の配列要素がNULLに設定されている場合、VirtualAddressArray内の対応する配列要素にある仮想アドレスはアンマップされます。PageArrayがNULLに設定されている場合、VirtualAddressArray内のすべての仮想アドレスがアンマップされます。
Requirements
ヘッダー: xmem.h ライブラリ: xmem.lib サポートされているプラットフォーム: XBOX One ファミリー本体および XBOX Series 本体See also
XMemVirtualAllocXMem