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

> Referência do PFMultiplayerAllocateMemoryCallback usado pela biblioteca C/C++ do PlayFab Multiplayer para solicitar um buffer de memória alocado dinamicamente.

Um retorno de chamada invocado sempre que um novo buffer de memória precisa ser alocado dinamicamente pela biblioteca do PlayFab Multiplayer.

## Sintaxe

```cpp theme={null}
typedef
void* (*PFMultiplayerAllocateMemoryCallback)(  
    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 PlayFab Multiplayer 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 tiver falhado.

## Comentários

Este retorno de chamada é instalado opcionalmente usando o método [PFMultiplayerSetMemoryCallbacks()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks). <br /><br /> O retorno de chamada precisa alocar e retornar um ponteiro para um bloco contíguo de memória do tamanho especificado que permanecerá válido até que o [PFMultiplayerFreeMemoryCallback](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback) correspondente do título seja invocado para liberá-lo. Se isso não for possível, o retorno de chamada precisará retornar nullptr para fazer a alocação falhar. À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 PlayFab Multiplayer falhem.   <br /><br /> Todo valor não nullptr retornado por este método será passado posteriormente ao [PFMultiplayerFreeMemoryCallback](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback) correspondente quando a memória não for mais necessária.

## Requisitos

**Cabeçalho:** PFMultiplayer.h

## Confira também

[Membros do PFMultiplayer](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members)\
[PFMultiplayerFreeMemoryCallback](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback)
[PFMultiplayerSetMemoryCallbacks](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks)


## Related topics

- [PFMultiplayerSetMemoryCallbacks](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks.md)
- [PFMultiplayerFreeMemoryCallback](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback.md)
- [Visão geral da API C/C++ do PFMultiplayer – PFMultiplayer.h](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members.md)
- [PartyAllocateMemoryCallback](/pt-BR/services/playfab/multiplayer/networking/reference/callbacks/partyallocatememorycallback.md)
- [game_chat_allocate_memory_callback](/pt-BR/reference/chat/gamechat2/functions/game_chat_allocate_memory_callback.md)