mstxMemHeapUnregister

产品支持情况

产品	是否支持
Atlas 350 加速卡	√
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	√
Atlas 训练系列产品	√

功能说明

注销内存池时，与之关联的Regions将一并被注销。

函数原型

void mstxMemHeapUnregister(mstxDomainHandle_t domain, mstxMemHeapHandle_t heap)

参数说明

表 1 参数说明

参数	输入/输出	说明
domain	输入	domain为内存池所属的域，为globalDomain或mstxDomainCreateA返回的句柄。数据类型：const char *。
heap	输入	heap为需要注销内存池的句柄，为mstxMemHeapRegister的返回值。 struct mstxMemHeap_st; typedef struct mstxMemHeap_st mstxMemHeap_t; typedef mstxMemHeap_t* mstxMemHeapHandle_t;

参数

输入/输出

说明

domain

输入

domain为内存池所属的域，为globalDomain或mstxDomainCreateA返回的句柄。

数据类型：const char *。

heap

输入

heap为需要注销内存池的句柄，为mstxMemHeapRegister的返回值。

struct mstxMemHeap_st;
typedef struct mstxMemHeap_st mstxMemHeap_t; 
typedef mstxMemHeap_t* mstxMemHeapHandle_t;

返回值说明

无

调用示例

mstxMemHeapDesc_t heapDesc{};
mstxMemHeapHandle_t memPool = mstxMemHeapRegister(globalDomain, &heapDesc); // 注册内存池
...
mstxMemHeapUnregister(globalDomain, memPool);                        // 注销内存池