Skip to content

环境句柄

环境句柄是XGCI所有句柄中的起始句柄,基于XGCI编写的应用程序中环境句柄有且至少出现一次。通常由 XGCIHandleAlloc()函数分配和初始化,在申请分配环境句柄时,需指定其句柄类型为HT_ENV。

/* 申请环境句柄示例 */
ret= XuguCIHandleAlloc(NULL,&hdenv,HT_ENV)

当函数调用成功后,函数返回XGCI_SUCCESS,参数hdenv返回指向申请成功的环境句柄指针。

环境句柄为 XGCI 函数的调用提供起始上下文环境,每一个环境句柄包含一个支持快速访问的内存缓存,所有的环境句柄下的内存分配都是通过这个缓存完成的。当多个线程在同一个环境句柄下申请句柄时,这些线程对缓存的访问是序列化的,即对环境句柄下独占的资源进行访问时会进行互斥加锁,以保证各个线程的安全稳定运行。