> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFMultiplayerAllocateMemoryCallback

> 動的に割り当てられたメモリ バッファーを要求するために PlayFab Multiplayer C/C++ ライブラリが使用する PFMultiplayerAllocateMemoryCallback のリファレンスです。

PlayFab Multiplayer ライブラリで新しいメモリ バッファーを動的に割り当てる必要があるたびに呼び出されるコールバックです。

## 構文

```cpp theme={null}
typedef
void* (*PFMultiplayerAllocateMemoryCallback)(  
    size_t size,  
    uint32_t memoryTypeId  
)  
```

### パラメーター

**`size`**   size\_t

実行する割り当てのサイズです。この値がゼロになることはありません。

**`memoryTypeId`**   uint32\_t

割り当てられるメモリの PlayFab Multiplayer ライブラリ内部カテゴリを表す不透明な識別子です。この値は無視する必要があります。

### 戻り値

型: void\*

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

## 解説

このコールバックは、[PFMultiplayerSetMemoryCallbacks()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks) メソッドを使用してオプションでインストールされます。<br /><br /> コールバックは、指定されたサイズの連続したメモリ ブロックを割り当ててそのポインターを返す必要があり、そのメモリは、タイトルの対応する [PFMultiplayerFreeMemoryCallback](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback) が呼び出されて解放されるまで有効である必要があります。これができない場合、コールバックは nullptr を返して割り当てを失敗させる必要があります。メモリの割り当てエラーは、ときに問題ないものと見なされますが、通常、現在の PlayFab Multiplayer ライブラリ操作が失敗する原因となります。<br /><br /> このメソッドから返された nullptr 以外のポインターはすべて、メモリが不要になった時点で対応する [PFMultiplayerFreeMemoryCallback](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback) にその後渡されます。

## 要件

**ヘッダー:** PFMultiplayer.h

## 関連項目

[PFMultiplayer のメンバー](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members)\
[PFMultiplayerFreeMemoryCallback](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback)\
[PFMultiplayerSetMemoryCallbacks](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks)


## Related topics

- [PFMultiplayerFreeMemoryCallback](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback.md)
- [PFMultiplayerSetMemoryCallbacks](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks.md)
- [PFMultiplayer C/C++ API の概要 - PFMultiplayer.h](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members.md)
- [PartyAllocateMemoryCallback](/ja-jp/services/playfab/multiplayer/networking/reference/callbacks/partyallocatememorycallback.md)
- [game_chat_allocate_memory_callback](/ja-jp/reference/chat/gamechat2/functions/game_chat_allocate_memory_callback.md)