函数：create_stream
产品支持情况
|
产品 |
是否支持 |
|---|---|
|
|
√ |
|
|
√ |
|
|
√ |
|
|
√ |
|
|
√ |
功能说明
在当前进程或线程中创建一个Stream。
该接口不支持设置Stream的优先级；若不设置，Stream的优先级默认为最高。如需在创建Stream时设置优先级，请参见acl.rt.create_stream_with_config接口。
若不显式调用Stream创建接口，那么每个Context对应一个默认Stream，该默认Stream是调用acl.rt.set_device接口或acl.rt.create_context接口隐式创建的，默认Stream的优先级不支持设置，为最高优先级。默认Stream适合简单、无复杂交互逻辑的应用，但缺点在于，在多线程编程中，执行结果取决于线程调度的顺序。显式创建的Stream适合大型、复杂交互逻辑的应用，且便于提高程序的可读性、可维护性，推荐显式。
函数原型
- C函数原型
1aclError aclrtCreateStream(aclrtStream *stream)
- python函数
1stream, ret = acl.rt.create_stream()
参数说明
无
返回值说明
|
返回值 |
说明 |
|---|---|
|
stream |
int，返回创建的Stream的指针地址。 |
|
ret |
int，错误码，返回0表示成功，返回其它值表示失败。 |
约束说明
|
型号 |
Stream最大数 |
|---|---|
|
|
1984 如果已存在多个默认Stream，只能显式创建N个Stream（N = 1984 - 默认Stream个数 - 执行内部同步的Stream个数）。 例如，若已存在一个默认Stream和一个执行内部同步的Stream，则只能显式创建2046个Stream。 |
|
|
512 如果已存在多个默认Stream，只能显式创建N个Stream（N = 512 - 默认Stream个数 - 执行内部同步的Stream个数）。 例如，若已存在一个默认Stream和一个执行内部同步的Stream，则只能显式创建510个Stream。 |
|
|
1024 如果已存在多个默认Stream，只能显式创建N个Stream（N = 1024 - 默认Stream个数 - 执行内部同步的Stream个数）。 例如，若已存在一个默认Stream和一个执行内部同步的Stream，则只能显式创建1022个Stream。 |
|
|
1024 |
|
|
2048 |