XblMemSetFunctions

Optionally sets the memory hook functions to allow callers to route memory allocations to their own memory manager.

Syntax

HRESULT XblMemSetFunctions(  
         XblMemAllocFunction memAllocFunc,  
         XblMemFreeFunction memFreeFunc  
)  

Parameters

memAllocFunc _In_opt_
Type: XblMemAllocFunction A pointer to the custom allocation callback to use, or a null pointer to restore the default. memFreeFunc _In_opt_
Type: XblMemFreeFunction A pointer to the custom freeing callback to use, or a null pointer to restore the default.

Return value

Type: HRESULT HRESULT return code for this API operation. Possible error codes include the following. This list isn’t exhaustive.

Return code	Description
E_XBL_ALREADY_INITIALIZED	The library is already initialized. Call this function before XblInitialize.
E_INVALIDARG	Only one of memAllocFunc and memFreeFunc is null.

Remarks

Call this function before XblInitialize. You can’t call it again until XblCleanupAsync completes. This function lets the app install custom memory allocation routines to service all requests for new memory buffers instead of using the default allocation routines. The memAllocFunc and memFreeFunc parameters can be null pointers to restore the default routines. Both callback pointers must be null or both must be non-null. Mixing custom and default routines isn’t permitted. This function also passes the callbacks to libHttpClient by calling HCMemSetFunctions. If libHttpClient is already initialized, it keeps its existing memory hooks, and this function still succeeds.

Requirements

Header: xbox_live_global_c.h Library: Microsoft.Xbox.Services.142.C.lib or Microsoft.Xbox.Services.143.C.lib

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

Syntax

Parameters

Return value

Remarks

Requirements

See also

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​See also

Syntax

Parameters

Return value

Remarks

Requirements

See also