> ## 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.

# PartyAllocateMemoryCallback

> 每當 Party 程式庫動態配置新的記憶體緩衝區時叫用的回呼。

每當 Party 程式庫動態配置新的記憶體緩衝區時叫用的回呼。

## 語法

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

### 參數

**`size`**   size\_t

要進行之配置的大小。此值永遠不會是零。

**`memoryTypeId`**   uint32\_t

不透明的識別碼，代表所配置之記憶體的 Party 程式庫內部類別。應忽略此值。

### 傳回值

類型：void\*

指向所配置之指定大小記憶體區塊的指標，如果配置失敗則為 nullptr。

## 備註

此回呼可選擇使用 [PartyManager::SetMemoryCallbacks()](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setmemorycallbacks) 方法安裝。 <br /><br /> 回呼必須配置並傳回指定大小之連續記憶體區塊的指標，該區塊在叫用遊戲對應的 [PartyFreeMemoryCallback](/zh-TW/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback) 加以釋放之前都必須保持有效。如果無法做到，回呼必須傳回 nullptr 使配置失敗。記憶體配置失敗有時被視為無害，但通常會導致目前的 Party 程式庫作業失敗。   <br /><br /> 此方法傳回的每個非 nullptr 值，都會在不再需要該記憶體時傳遞給對應的 [PartyFreeMemoryCallback](/zh-TW/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback)。

## 需求

**標頭：** Party.h

## 另請參閱

[Party 成員](/zh-TW/services/playfab/multiplayer/networking/reference/party_members)\
[PartyFreeMemoryCallback](/zh-TW/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback)\
[PartyManager::SetMemoryCallbacks](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setmemorycallbacks)\
[PartyManager::GetMemoryCallbacks](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getmemorycallbacks)


## Related topics

- [PartyFreeMemoryCallback](/zh-TW/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback.md)
- [PartyManager::SetMemoryCallbacks](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setmemorycallbacks.md)
- [PartyManager::GetMemoryCallbacks](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getmemorycallbacks.md)
- [PartyXblManager::SetMemoryCallbacks](/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_setmemorycallbacks.md)
- [PartyXblManager::GetMemoryCallbacks](/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getmemorycallbacks.md)