aclrtSetDevice

函数功能

指定当前进程或线程中用于运算的Device，同时隐式创建默认Context。同步接口。

对于昇腾310 AI处理器，该默认Context中包含2个Stream，1个默认Stream和1个执行内部同步的Stream。

对于昇腾910 AI处理器，该默认Context中包含1个默认Stream。

对于昇腾310P AI处理器，在标准形态下，该默认Context中包含2个Stream，1个默认Stream和1个执行内部同步的Stream。

约束说明

如果多次调用aclrtSetDevice接口而不调用aclrtResetDevice接口释放本进程使用的Device资源，功能上不会有问题，因为在进程退出时也会释放本进程使用的Device资源。建议aclrtSetDevice接口和aclrtResetDevice接口配对使用，在不使用Device上资源时，通过调用aclrtResetDevice接口及时释放本进程使用的Device资源。

支持以下使用场景：

• 在不同进程或线程中支持调用aclrtSetDevice接口指定同一个Device用于运算。在同一个进程中的多个线程中，如果调用aclrtSetDevice接口指定同一个Device用于运算，这时隐式创建的默认Context是同一个。
• 在某一进程中指定Device，该进程内的多个线程可共用此Device显式创建Context（aclrtCreateContext接口）。
• 多Device场景下，可在进程中通过aclrtSetDevice接口切换到其它Device。但利用Context切换（调用aclrtSetCurrentContext接口）来切换Device，比使用aclrtSetDevice接口效率高。

函数原型

aclError aclrtSetDevice(int32_t deviceId)

参数说明

返回值说明

返回0表示成功，返回其它值表示失败。

参考资源

接口调用流程及示例，参见运行管理资源申请与释放。