PFMultiplayerAllocateMemoryCallback
新しいメモリ バッファーを PlayFab マルチプレイヤー ライブラリによって動的に割り当てる必要が生じるたびに呼び出されるコールバック。
構文
typedef
void* (*PFMultiplayerAllocateMemoryCallback)(
size_t size,
uint32_t memoryTypeId
)
パラメーター
size
size_t
割り当てのサイズ。 この値を 0 にすることはできません。
memoryTypeId
uint32_t
割り当てられているメモリの PlayFab マルチプレイヤー ライブラリの内部カテゴリを表す不透明な識別子。 この値は無視してください。
戻り値
型: void*
指定サイズで割り当てられたメモリ ブロックのポインター。または割り当てに失敗した場合は nullptr。
解説
このコールバックは、必要に応じて、PFMultiplayerSetMemoryCallbacks() メソッドを使用してインストールされます。
コールバックは、指定されたサイズの連続したメモリ ブロックを割り当てて、このメモリ ブロックのポインターを返す必要があります。このメモリ ブロックは、タイトルの対応するPFMultiplayerFreeMemoryCallback が呼び出されて解放されるまで有効な状態が維持されます。 この動作が可能でない場合、コールバックは割り当ての失敗を示す nullptr を返す必要があります。 メモリの割り当てエラーは、無害であると見なされることもありますが、通常は、現在の PlayFab マルチプレイヤー ライブラリ操作の失敗の原因になります。
このメソッドによって返された nullptr 以外はすべて、その後メモリが不要になると、対応する PFMultiplayerFreeMemoryCallback に渡されます。
要件
ヘッダー: PFMultiplayer.h
関連項目
PFMultiplayer メンバー
PFMultiplayerFreeMemoryCallback
PFMultiplayerSetMemoryCallbacks