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

> game_chat_free_memory_callback

# game\_chat\_free\_memory\_callback

代表每當 Game Chat 2 程式庫不再需要先前配置的記憶體緩衝區且可將其釋放時所叫用的回呼。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
typedef  
void  
(game_chat_callback * game_chat_free_memory_callback)(  
    _In_ _Post_invalid_ void * pointer,  
    _In_ uint32_t memoryTypeId  
    );  
```

<a id="parametersSection" />

### 參數

*pointer*   \_In\_ \_Post\_invalid\_\
類型：void\*

先前配置之記憶體緩衝區的指標。此值永遠不會是 null 指標。

*memoryTypeId*   \_In\_\
類型：uint32\_t

不透明的識別碼，代表要釋放之記憶體的 Game Chat 2 內部類別。

<a id="remarksSection" />

## 備註

此函式代表自訂回呼，如果有提供，每當 Game Chat 2 程式庫不再需要先前配置的記憶體緩衝區且可將其釋放時，就會叫用此回呼。此回呼為選用，可藉由呼叫 [chat\_manager::set\_memory\_callbacks](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_memory_callbacks) 方法來安裝。如果未安裝自訂回呼，Game Chat 2 會使用自己的預設函式來配置和釋放記憶體。您可以使用 [chat\_manager::get\_memory\_callbacks](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_memory_callbacks) 方法，判斷您的應用程式是使用預設函式還是自訂函式來配置和釋放記憶體。

<Note>如果您想要使用自訂函式來配置和釋放記憶體，必須實作一組對應的 [game\_chat\_allocate\_memory\_callback](/zh-TW/reference/chat/gamechat2/functions/game_chat_allocate_memory_callback) 和 `game_chat_free_memory_callback` 函式。您無法混用自訂函式和預設函式來配置和釋放記憶體。</Note>

每當 Game Chat 2 程式庫用完先前由應用程式對應的 [game\_chat\_allocate\_memory\_callback](/zh-TW/reference/chat/gamechat2/functions/game_chat_allocate_memory_callback) 所傳回的記憶體緩衝區時，就會叫用此回呼，表示應用程式可以釋放該記憶體緩衝區。

<a id="requirementsSection" />

## 需求

**標頭：** GameChat2.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

<a id="seealsoSection" />

## 另請參閱

[Game Chat 2 簡介](/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/zh-TW/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[GameChat2 成員](/zh-TW/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [chat_manager::set_memory_callbacks](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_memory_callbacks.md)
- [chat_manager::get_memory_callbacks](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_memory_callbacks.md)
- [game_chat_allocate_memory_callback](/zh-TW/reference/chat/gamechat2/functions/game_chat_allocate_memory_callback.md)
- [GameChat2 成員](/zh-TW/reference/chat/gamechat2/gamechat2_members.md)
- [PartyFreeMemoryCallback](/zh-TW/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback.md)