XMemCreateWin32Heap
Win32 ヒープを作成します。Syntax
Parameters
HeapFlags _In_型: ULONGLONG 作成するヒープのメモリ ソースを示します。
baseAddress _In_
型: PVOID インプレース ヒープ割り当てのベース アドレス。
HeapFlags が XMEM_HEAP_INPLACE に設定されている場合、この値は 4-KB 境界に整列されたコミットされたメモリ内のアドレスを指す必要があります。それ以外の場合、この値は NULL に設定する必要があります。
Return value
型: HANDLE 成功した場合、作成された Win32 ヒープへのハンドルを返します。それ以外の場合はNULL を返します。利用可能な場合、拡張エラー情報はアプリの現在の XErrorCallback コールバックに提供されます。
Remarks
この関数は Win32 ヒープを作成し、HeapFlags と baseAddress によって示されるソースとベース アドレスからヒープのメモリを割り当てます。ヒープの作成時に HeapFlags で XMEM_HEAP_INPLACE が指定されなかった場合、ヒープは 2MB ページ (XMEM_HEAP_64K_PAGES が指定されている場合は 64KB ページ) によってバッキングされます。Win32 ヒープを作成しようとしているときにエラーが発生した場合、このメソッドは NULL を返し、利用可能な場合はエラーがアプリの現在の XErrorCallback コールバックに報告されます。例外的なエラーの処理の詳細については、XError を参照してください。
メモリの構成とアクセスの詳細については、Configuring memory for your title and dev kit を参照してください。
ツール メモリの割り当て
HeapFlags に XMEM_HEAP_TOOL が指定されている場合、関数は、プロファイリング モードとイテレーション モードの設定に応じて、Win32 ヒープを作成するためにツール パーティションからメモリを割り当てようとします。
- イテレーション モードが無効でプロファイリング モードが有効な場合、関数はツール パーティションから要求された量のメモリを割り当てようとします。要求された量が利用できない場合、エラーが発生します。
- イテレーション モードが無効でプロファイリング モードも無効な場合、エラーが発生します。
- イテレーション モードが有効な場合、関数はタイトル パーティションから要求された量のメモリを割り当てようとします。要求された量が利用できない場合、エラーが発生します。
Requirements
ヘッダー: xmem.h ライブラリ: xmem.lib サポートされているプラットフォーム: XBOX One ファミリー本体および XBOX Series 本体See also
MemoryXMem