Skip to main content

XMemMakeTag

Creates a 24-bit tag based on a four-character code.

Syntax

Parameters

Tag   _In_
Type: UINT32
The four-character code used to create the 24-bit tag. The code supports lowercase and uppercase letters (a-z and A-Z), digits (0-9), and the dollar symbol ($). An invalid character input is read back as an asterisk (*).

Return value

Type: ULONGLONG 24-bit tag code, placed in the upper 24 bits of a 64-bit ULONGLONG.

Remarks

This function is a helper function that you can use to incorporate an optional 4-character tag, using a bitwise-OR combination, into the XMemFlags parameter for the XMemAllocatePhysicalPages and XMemVirtualAlloc functions. The optional 4-character tag is applied to the range of pages identified by these functions. You can retrieve that tag as part of the XMemFlags member in the XMEM_BASIC_INFORMATION structure, returned by XMemVirtualQuery. For more information about working with the memory manager, see Working with the Microsoft GDK Game OS memory manager.

Requirements

Header: xmem.h Library: xmem.lib Supported platforms: XBOX One family consoles and XBOX Series consoles

See also

Memory
XMem
Last modified on August 20, 2026