函数：create_context

产品支持情况

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 训练系列产品	√
Atlas 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 200/300/500 推理产品	√

使用说明

C函数原型	aclError *aclrtCreateContext(aclrtContext context, int32_t deviceId)**
Python函数	context, ret = acl.rt.create_context(device_id)
函数功能	在当前进程或线程中显式创建一个Context。对于 Atlas 200/300/500 推理产品，该Context中包含2个Stream，1个默认Stream和1个执行内部同步的Stream。对于 Atlas 200I/500 A2 推理产品，该Context中包含2个Stream，1个默认Stream和1个执行内部同步的Stream。对于 Atlas 训练系列产品，该Context中包含1个默认Stream。对于 Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件，该Context中包含1个默认Stream。对于 Atlas 推理系列产品，在标准形态下，该Context中包含2个Stream，1个默认Stream和1个执行内部同步的Stream。对于 Atlas A3 训练系列产品/Atlas A3 推理系列产品，该Context中包含1个默认Stream。说明：如果在应用程序中没有调用acl.rt.set_device接口，那么在首次调用acl.rt.create_context接口时，系统内部会根据该接口传入的Device ID，为该Device绑定一个默认Stream（一个Device仅绑定一个默认Stream），因此在首次调用acl.rt.create_context接口时，占用的Stream数量 = Device上绑定的默认Stream + Context中包含的Stream。
输入说明	device_id：int，指定需要创建Context的Device设备号。
返回值说明	context：int，表示创建的Context的指针地址。 ret：int，错误码。返回0表示成功。返回其它值表示失败。
约束说明	支持以下使用场景：若不调用acl.rt.create_context接口显式创建Context，那系统会使用默认Context，该默认Context是在调用acl.rt.set_device接口时隐式创建的。隐式创建Context：适合简单、无复杂交互逻辑的应用，但缺点在于，在多线程编程中，执行结果取决于线程调度的顺序。显式创建Context：适合大型、复杂交互逻辑的应用，便于提高程序的可读性、可维护性。在某一进程中指定Device，该进程内的多个线程可共用在此Device上显式创建的Context（调用acl.rt.create_context接口显式创建Context）。若在某一进程内创建多个Context（Context的数量与Stream相关，Stream数量有限制，请参见acl.rt.create_stream），当前线程在同一时刻内只能使用其中一个Context，建议通过acl.rt.set_context接口明确指定当前线程的Context，增加程序的可维护性。
参考资源	接口调用流程与示例，请参见运行时资源申请与释放。

父主题： Context管理