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

> 동적으로 할당된 메모리 버퍼를 요청하기 위해 PlayFab Multiplayer C/C++ 라이브러리에서 사용하는 PFMultiplayerAllocateMemoryCallback에 대한 참조입니다.

PlayFab Multiplayer 라이브러리에서 새로운 메모리 버퍼를 동적으로 할당해야 할 때마다 호출되는 콜백입니다.

## 구문

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

### 매개 변수

**`size`**   size\_t

수행할 할당의 크기입니다. 이 값은 0이 되지 않습니다.

**`memoryTypeId`**   uint32\_t

할당되는 메모리의 PlayFab Multiplayer 라이브러리 내부 범주를 나타내는 불투명 식별자입니다. 이 값은 무시되어야 합니다.

### 반환 값

형식: void\*

지정된 크기의 할당된 메모리 블록에 대한 포인터이거나 할당이 실패한 경우 nullptr입니다.

## 설명

이 콜백은 [PFMultiplayerSetMemoryCallbacks()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks) 메서드를 사용하여 선택적으로 설치됩니다. <br /><br /> 콜백은 지정된 크기의 연속된 메모리 블록에 대한 포인터를 할당하고 반환해야 하며, 이는 타이틀의 해당 [PFMultiplayerFreeMemoryCallback](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback)이 이를 해제하기 위해 호출될 때까지 유효한 상태로 유지되어야 합니다. 이것이 불가능한 경우 콜백은 nullptr을 반환하여 할당에 실패해야 합니다. 메모리 할당 실패는 때때로 무해한 것으로 간주되지만 일반적으로 현재 PlayFab Multiplayer 라이브러리 작업이 실패하게 만듭니다.   <br /><br /> 이 메서드에서 반환된 모든 nullptr이 아닌 값은 메모리가 더 이상 필요하지 않게 되면 해당 [PFMultiplayerFreeMemoryCallback](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback)에 전달됩니다.

## 요구 사항

**헤더:** PFMultiplayer.h

## 함께 보기

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


## Related topics

- [PFMultiplayerFreeMemoryCallback](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback.md)
- [PFMultiplayerSetMemoryCallbacks](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks.md)
- [PFMultiplayer C/C++ API 개요 - PFMultiplayer.h](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members.md)
- [PartyAllocateMemoryCallback](/ko/services/playfab/multiplayer/networking/reference/callbacks/partyallocatememorycallback.md)
- [game_chat_allocate_memory_callback](/ko/reference/chat/gamechat2/functions/game_chat_allocate_memory_callback.md)