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

# PartyAllocateMemoryCallback

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

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

## Syntax

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

### Parameters

**`size`**   size\_t

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

**`memoryTypeId`**   uint32\_t

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

### Return value

Type: void\*

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

## Remarks

このコールバックは、[PartyManager::SetMemoryCallbacks()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setmemorycallbacks.md) メソッドを使用してオプションでインストールされます。\
\
&#x20;このコールバックは、指定されたサイズの連続したメモリ ブロックを割り当て、そのポインタを返す必要があります。このメモリは、タイトルの対応する [PartyFreeMemoryCallback](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback.md) が呼び出されて解放されるまで有効なままである必要があります。これができない場合、コールバックは nullptr を返して割り当てを失敗させる必要があります。メモリ割り当ての失敗は良性と見なされることもありますが、通常は現在の Party ライブラリ操作を失敗させます。   \
\
&#x20;このメソッドから返された nullptr 以外の値はすべて、メモリが不要になった時点で対応する [PartyFreeMemoryCallback](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback.md) に渡されます。

## Requirements

**Header:** Party.h

## See also

[Party members](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/party_members.md)\
[PartyFreeMemoryCallback](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback.md)\
[PartyManager::SetMemoryCallbacks](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setmemorycallbacks.md)\
[PartyManager::GetMemoryCallbacks](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getmemorycallbacks.md)


## Related topics

- [PartyFreeMemoryCallback](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback.md)
- [PartyManager::GetMemoryCallbacks](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getmemorycallbacks.md)
- [PartyManager::SetMemoryCallbacks](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setmemorycallbacks.md)
- [PartyXblManager::SetMemoryCallbacks](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_setmemorycallbacks.md)
- [PartyXblManager::GetMemoryCallbacks](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getmemorycallbacks.md)
