aclrtCreateStream

函数功能

在当前进程或线程中创建一个Stream，同步接口。

约束说明

• 每个Context对应一个默认Stream，该默认Stream是调用aclrtSetDevice接口或aclrtCreateContext接口隐式创建的。推荐调用aclrtCreateStream接口显式创建Stream。
  • 隐式创建Stream：适合简单、无复杂交互逻辑的应用，但缺点在于，在多线程编程中，执行结果取决于线程调度的顺序。
  • 显式创建Stream：推荐显式，适合大型、复杂交互逻辑的应用，且便于提高程序的可读性、可维护性。
• 对于Atlas 200/300/500 推理产品，硬件资源最多支持1024个Stream，如果已存在多个默认Stream，只能显式创建N个Stream（N=1024-默认Stream个数-执行内部同步的Stream个数），例如，若已存在一个默认Stream和一个执行内部同步的Stream，则只能显式创建1022个Stream。
• 对于Atlas 200/500 A2推理产品，硬件资源最多支持512个Stream，如果已存在多个默认Stream，只能显式创建N个Stream（N=512-默认Stream个数-执行内部同步的Stream个数），例如，若已存在一个默认Stream和一个执行内部同步的Stream，则只能显式创建510个Stream。
• 对于Atlas 推理系列产品，硬件资源最多支持1024个Stream，
  • 标准形态下，如果已存在多个默认Stream，只能显式创建N个Stream（N=1024-默认Stream个数-执行内部同步的Stream个数），例如，若已存在一个默认Stream和一个执行内部同步的Stream，则只能显式创建1022个Stream。
• 对于Atlas 训练系列产品，硬件资源最多支持2048个Stream，如果已存在多个默认Stream，只能显式创建N个Stream（N=2048-默认Stream个数-执行内部同步的Stream个数），例如，若已存在一个默认Stream和一个执行内部同步的Stream，则只能显式创建2046个Stream。
• 对于Atlas A2训练系列产品，硬件资源最多支持2048个Stream，如果已存在多个默认Stream，只能显式创建N个Stream（N=2048-默认Stream个数-执行内部同步的Stream个数），例如，若已存在一个默认Stream和一个执行内部同步的Stream，则只能显式创建2046个Stream。

函数原型

aclError aclrtCreateStream(aclrtStream *stream)

参数说明

返回值说明

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

参考资源

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