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

> Um retorno de chamada invocado sempre que a biblioteca do Party aloca dinamicamente um novo buffer de memória.

Um retorno de chamada invocado sempre que a biblioteca do Party aloca dinamicamente um novo buffer de memória.

## Sintaxe

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

### Parâmetros

**`size`**   size\_t

O tamanho da alocação a ser feita. Esse valor nunca será zero.

**`memoryTypeId`**   uint32\_t

Um identificador opaco que representa a categoria interna de memória da biblioteca do Party que está sendo alocada. Esse valor deve ser ignorado.

### Valor retornado

Tipo: void\*

Um ponteiro para um bloco de memória alocado do tamanho especificado ou nullptr se a alocação falhar.

## Comentários

Este retorno de chamada é instalado opcionalmente usando o método [PartyManager::SetMemoryCallbacks()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setmemorycallbacks.md). \
\
 O retorno de chamada deve alocar e retornar um ponteiro para um bloco contíguo de memória do tamanho especificado que permaneça válido até que o [PartyFreeMemoryCallback](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback.md) correspondente do título seja invocado para liberá-lo. Se isso não for possível, o retorno de chamada deverá retornar nullptr para que a alocação falhe. Às vezes, as falhas de alocação de memória são consideradas benignas, mas geralmente fazem com que as operações atuais da biblioteca do Party falhem.   \
\
 Todo valor diferente de nullptr retornado por este método é então passado para o [PartyFreeMemoryCallback](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback.md) correspondente quando a memória não for mais necessária.

## Requisitos

**Cabeçalho:** Party.h

## Confira também

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


## Related topics

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