Skip to main content

XMEM_SET_ALLOCATION_HOOKS

Usada por los títulos para registrar enlaces de asignación de memoria.

Sintaxis

Parámetros

AllocRoutine In Tipo: PXMEMALLOC_ROUTINE Puntero a la función de asignación del título. Consulte el tema XMEMALLOC_ROUTINE para ver la definición de esta función. FreeRoutine In
Tipo: PXMEMFREE_ROUTINE
Puntero a la función de desasignación del título. Consulte el tema XMEMFREE_ROUTINE para ver la definición de esta función.

Comentarios

Las asignaciones se pueden supervisar (o invalidar) con una devolución de llamada proporcionada por el título a través de la macro XMEM_SET_ALLOCATION_HOOKS. Con un uso adecuado de esta macro, los títulos pueden realizar el seguimiento de todas las asignaciones realizadas desde el código del título, así como del código de la plataforma. Si los títulos deciden no proporcionar sus propios enlaces de asignación, se usarán XMemAllocDefault y XMemFreeDefault en su lugar (consulte xmem.h para ver la declaración de estos enlaces). Si los títulos desean proporcionar enlaces de asignación con fines de seguimiento, pero no quieren implementar su propio asignador, pueden llamar directamente al asignador predeterminado. Es importante proporcionar una implementación tanto de XMEMALLOC_ROUTINE como de XMEMFREE_ROUTINE si los enlaza; enlazar solo uno de ellos se considerará un error. Los enlaces proporcionados por el título se exportan desde el archivo ejecutable del juego y se vinculan en el momento de la carga de xmem.dll (normalmente, el momento en que se inicia el juego).
Las funciones registradas por XMemSetAllocationHooks deben definirse dentro del archivo exe del juego para garantizar que las direcciones se rellenen de forma estática. Si los punteros de función proporcionados hacen referencia a funciones de DLL a los que hace referencia el archivo exe del juego, el compilador debe emitir código inicializador estático para rellenar la memoria, que puede ejecutarse después de que la plataforma haya consultado los enlaces de invalidación, lo que da lugar a un comportamiento impredecible. Si la plataforma detecta que esto puede haber ocurrido, aparecerá una advertencia en la ventana de salida del depurador.

Requisitos

Encabezado: xmem.h Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX Series

Consulte también

Referencia de XMem
XMEM_ALLOCATION_HOOKS
XMEMALLOC_ROUTINE
XMEMFREE_ROUTINE
Last modified on October 19, 2026