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

> 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()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setmemorycallbacks). <br /><br /> 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](/pt-BR/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback) 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.   <br /><br /> Todo valor diferente de nullptr retornado por este método é então passado para o [PartyFreeMemoryCallback](/pt-BR/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback) correspondente quando a memória não for mais necessária.

## Requisitos

**Cabeçalho:** Party.h

## Confira também

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


## Related topics

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