mstxMemRegionsRegister
函数原型
void mstxMemRegionsRegister(mstxDomainHandle_t domain, mstxMemRegionsRegisterBatch_t const *desc)
功能说明
注册内存池二次分配。用户需保证RegionsRegister的内存位于mstxMemHeapRegister注册的范围内，否则工具会提示越界读写。
参数说明
参数 |
输入/输出 |
说明 |
|---|---|---|
domain |
输入 |
为globalDomain或mstxDomainCreateA返回的句柄。 数据类型：const char *。 |
desc |
输入 |
内存池待二次分配的内存区域描述信息，不能为空。 struct mstxMemRegion_st; typedef struct mstxMemRegion_st mstxMemRegion_t; typedef mstxMemRegion_t* mstxMemRegionHandle_t; typedef struct mstxMemRegionsRegisterBatch_t { mstxMemHeapHandle_t heap; // 要进行二次分配的内存池句柄 mstxMemType regionType; // 内存区域的内存类型 size_t regionCount; // 内存区域的个数 void const *regionDescArray; // 内存区域描述数据 mstxMemRegionHandle_t* regionHandleArrayOut; // 返回的注册二次分配得到的句柄数组 } mstxMemRegionsRegisterBatch_t; |
返回值
无。
调用示例
mstxMemRegionsRegisterBatch_t regionsDesc{};
regionsDesc.heap = memPool;
regionsDesc.regionType = MSTX_MEM_TYPE_VIRTUAL_ADDRESS;
regionsDesc.regionCount = 1;
regionsDesc.regionDescArray = rangesDesc;
regionsDesc.regionHandleArrayOut = regionHandles;
mstxMemRegionsRegister(globalDomain, ®ionsDesc); // 二次分配注册
父主题： 扩展接口（mstx）