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

# XblMemSetFunctions

> XblMemSetFunctions

# XblMemSetFunctions

（可选）设置内存挂钩函数，以允许调用方将内存分配路由到其自己的内存管理器。

## 语法

```cpp theme={null}
HRESULT XblMemSetFunctions(  
         XblMemAllocFunction memAllocFunc,  
         XblMemFreeFunction memFreeFunc  
)  
```

### 参数

*memAllocFunc*   \_In\_opt\_\
类型：XblMemAllocFunction

指向要使用的自定义分配回调的指针，或指定空指针以恢复默认值。

*memFreeFunc*   \_In\_opt\_\
类型：XblMemFreeFunction

指向要使用的自定义释放回调的指针，或指定空指针以恢复默认值。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

必须在 XblInitialize() 之前调用此方法，且在 XblCleanup() 之前不能再次调用。此方法允许应用程序安装自定义内存分配例程，以使用它们来处理所有新内存缓冲区的请求，而不是使用默认分配例程。*memAllocFunc* 和 *memFreeFunc* 参数可以是空指针以恢复默认例程。两个回调指针必须都为 null，或者都不为 null。不允许混合使用自定义例程和默认例程。

## 要求

**头文件：** xbox\_live\_global\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[xbox\_live\_global\_c](/reference/live/xsapi-c/xbox_live_global_c/xbox_live_global_c_members)


## Related topics

- [XblMemGetFunctions](/zh-CN/reference/live/xsapi-c/xbox_live_global_c/functions/xblmemgetfunctions.md)
- [XblInitialize](/zh-CN/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize.md)
- [XblCleanupAsync](/zh-CN/reference/live/xsapi-c/xbox_live_global_c/functions/xblcleanupasync.md)
- [XSAPI C 概述](/zh-CN/services/xbox-services/fundamentals/xbox-services-api/live-xsapi-flat-c.md)
- [HCMemSetFunctions](/zh-CN/reference/live/httpclient/httpclient/functions/hcmemsetfunctions.md)