PartyAllocateMemoryCallback

パーティー ライブラリが新しいメモリ バッファーを動的に割り当てるたびに呼び出されるコールバック。

構文

typedef
void* (*PartyAllocateMemoryCallback)(  
    size_t size,  
    uint32_t memoryTypeId  
)  

パラメーター

size size_t

割り当てのサイズ。 この値を 0 にすることはできません。

memoryTypeId uint32_t

割り当てられるメモリのライブラリ ライブラリ内部カテゴリを表す非透過的な識別子。 この値は無視してください。

戻り値

型: void*

指定サイズで割り当てられたメモリ ブロックのポインター。または割り当てに失敗した場合は nullptr。

解説

このコールバックは、必要に応じて、PartyManager::SetMemoryCallbacks() メソッドを使用してインストールされます。

コールバックは、指定されたサイズの連続したメモリ ブロックを割り当てて、このメモリ ブロックのポインターを返す必要があります。このメモリ ブロックは、タイトルの対応するPartyFreeMemoryCallback が呼び出されて解放されるまで有効な状態が維持されます。 この動作が可能でない場合、コールバックは割り当ての失敗を示す nullptr を返す必要があります。 メモリの割り当てエラーは、無害であると見なされることもありますが、通常は、現在のパーティー ライブラリ操作の失敗の原因になります。

このメソッドによって返された nullptr 以外はすべて、その後メモリが不要になると、対応する PartyFreeMemoryCallback に渡されます。

要件

ヘッダー: Party.h

関連項目

パーティーのメンバー
PartyFreeMemoryCallback
PartyManager::SetMemoryCallbacks
PartyManager::GetMemoryCallbacks