game_chat_allocate_memory_callback

每次必须由游戏聊天库动态分配新的内存缓冲区时调用的回调。

语法

typedef
_Ret_maybenull_
_Post_writable_byte_size_(size) void *
(game_chat_callback * game_chat_allocate_memory_callback)(
    _In_ size_t size,
    _In_ uint32_t memoryTypeId
    );

参数

size _In_
类型:size_t

要分配的大小。 该值绝不会为零。

memoryTypeId _In_
类型:uint32_t

指向指定大小的已分配内存块的指针,如果分配失败,则为 null 指针。

备注

此回拨可以使用 chat_manager::set_memory_callbacks() 的方法选择性安装。

回调必须分配并返回指向指定大小的连续内存块的指针,该内存将保持有效,直到调用该应用的相应 game_chat_free_memory_callback 以释放它为止。 如果这不可行,回调必须返回 null 指针以使分配失败。 内存分配失败有时被视为是良性的,但通常会导致当前游戏聊天库操作失败。

要求

头文件:GameChat2.h

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

GameChat2 成员
chat_manager::get_memory_callbacks
chat_manager::set_memory_callbacks