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

# game_chat_allocate_memory_callback

> game_chat_allocate_memory_callback

# game\_chat\_allocate\_memory\_callback

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

## Sintaxe

```cpp theme={null}
typedef
_Ret_maybenull_
_Post_writable_byte_size_(size) void *
(game_chat_callback * game_chat_allocate_memory_callback)(
    _In_ size_t size,
    _In_ uint32_t memoryTypeId
    );
```

### Parâmetros

*size*   \_In\_\
Tipo: size\_t

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

*memoryTypeId*   \_In\_\
Tipo: uint32\_t

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

## Comentários

Esse retorno de chamada é instalado opcionalmente usando o método chat\_manager::set\_memory\_callbacks().

O retorno de chamada deve alocar e retornar um ponteiro para um bloco contíguo de memória do tamanho especificado que
permanecerá válido até que o [game\_chat\_free\_memory\_callback](/pt-BR/reference/chat/gamechat2/functions/game_chat_free_memory_callback) correspondente do aplicativo seja invocado para liberá-lo.
Se isso não for possível, o retorno de chamada deverá retornar um ponteiro nulo para que a alocação falhe. Às vezes, as falhas de alocação de memória
são consideradas benignas, mas geralmente farão com que as operações atuais da biblioteca do Game Chat falhem.

## Requisitos

**Cabeçalho:** GameChat2.h

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Membros do GameChat2](/pt-BR/reference/chat/gamechat2/gamechat2_members)\
[chat\_manager::get\_memory\_callbacks](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_memory_callbacks)\
[chat\_manager::set\_memory\_callbacks](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_memory_callbacks)


## Related topics

- [game_chat_allocate_memory_callback](/ja-jp/reference/chat/gamechat2/functions/game_chat_allocate_memory_callback.md)
- [game_chat_free_memory_callback](/reference/chat/gamechat2/functions/game_chat_free_memory_callback.md)
- [chat_manager::get_memory_callbacks](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_memory_callbacks.md)
- [chat_manager::set_memory_callbacks](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_memory_callbacks.md)