> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFMemFreeFunction

> 타이틀의 PFMemAllocFunction 콜백이 할당한 null이 아닌 메모리 버퍼를 PlayFab이 더 이상 필요로 하지 않을 때 해제하기 위해 호출하는 콜백입니다.

PlayFab이 할당한 메모리 버퍼가 더 이상 필요하지 않아 해제할 수 있을 때마다 호출하는 콜백입니다.

## 구문

```cpp theme={null}
void STDAPIVCALLTYPE PFMemFreeFunction(
    void* pointer,
    uint32_t memoryTypeId
);
```

### 매개 변수

**`pointer`**   `_In_ _Post_invalid_` void\*

[PFMemAllocFunction](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplatform/functions/pfmemallocfunction.md) 콜백이 할당한 메모리 버퍼에 대한 포인터입니다. 이 값은 `nullptr`이 아닙니다. 콜백이 반환된 후에는 포인터가 유효하지 않습니다.

**`memoryTypeId`**   `_In_` uint32\_t

해제되는 메모리의 내부 범주에 대한 불투명 식별자입니다. 이 값은 무시하세요.

### 반환 값

형식: void

## 설명

이 콜백을 설치하려면 [PFMemoryHooks](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplatform/structs/pfmemoryhooks.md) 구조체의 `free` 멤버에 설정하고 [PFInitialize](https://docs.xbox.com/ko/services/playfab/api-references/c/pfcore/functions/pfinitialize.md)를 호출하기 전에 해당 구조체를 [PFMemSetFunctions](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplatform/functions/pfmemsetfunctions.md)에 전달하세요. 동시에 `alloc` 멤버를 일치하는 PFMemAllocFunction 콜백으로 설정하세요. 두 멤버 중 하나만 설정된 경우 PFMemSetFunctions는 `E_INVALIDARG`를 반환합니다.

PlayFab은 PFMemAllocFunction 콜백이 반환한 메모리 버퍼의 사용을 마치면 이 콜백을 호출하여 버퍼를 해제할 수 있도록 합니다. PlayFab은 `nullptr`을 사용하여 이 콜백을 호출하지 않습니다.

PFMemSetFunctions를 호출할 때 libHttpClient가 아직 초기화되지 않은 경우 PlayFab은 libHttpClient의 해제를 이 콜백을 통해 라우팅하는 후크도 설치합니다.

PlayFab은 여러 스레드에서 이 콜백을 호출할 수 있으므로 스레드로부터 안전하게 만드세요.

## 요구 사항

**헤더:** PFPlatform.h

**라이브러리:** PlayFabCore.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 참고 항목

[PFPlatform 멤버](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplatform/pfplatform_members.md)

[PFMemoryHooks](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplatform/structs/pfmemoryhooks.md)

[PFMemAllocFunction](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplatform/functions/pfmemallocfunction.md)


## Related topics

- [PFMemAllocFunction](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplatform/functions/pfmemallocfunction.md)
- [PFMemoryHooks](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplatform/structs/pfmemoryhooks.md)
- [HCMemFreeFunction](https://docs.xbox.com/ko/reference/live/httpclient/httpclient/functions/hcmemfreefunction.md)
- [XblMemFreeFunction](https://docs.xbox.com/ko/reference/live/xsapi-c/xbox_live_global_c/functions/xblmemfreefunction.md)
- [HCMemAllocFunction](https://docs.xbox.com/ko/reference/live/httpclient/httpclient/functions/hcmemallocfunction.md)