函数：ptr_to_bytes

函数：ptr_to_numpy

note

须知

该接口即将废弃，建议使用acl.util.ptr_to_bytes接口。

C函数原型	无
Python函数	output = acl.util.ptr_to_numpy(ptr, shape, type)
函数功能	将指针地址数据转换为numpy数组，可以使Python代码直接访问。
输入说明	ptr：int，C语言中的指针地址，是能够访问的数据的首地址。 shape：tuple，需要构造的numpy的shape。 type：int，表示ptr中数据的数据类型。 下面举例一些常用的类型（未列出类型详见Numpy手册，NumPy C-API中的数据类型API，以下列出类型以手册中数据为准）： - 0：NPY_BOOL - 1：NPY_BYTE，NPY_INT8 - 2：NPY_UINT8 - 3：NPY_SHORT，NPY_INT16 - 4：NPY_USHORT，NPY_UINT16 - 5：NPY_INT，NPY_INT32 - 6：NPY_UINT，NPY_UINT32 - 7：NPY_INT64 - 8：NPY_UINT64 - 9：NPY_LONGLONG - 10：NPY_ULONGLONG - 11：NPY_FLOAT32 - 12：NPY_DOUBLE - 23：NPY_HALF，NPY_FLOAT16
返回值说明	output：numpy类型。
约束说明	无
注意事项	- 修改示例如下： text<br> np_arr_out = acl.util.ptr_to_numpy(host_ptr, np_arr_in.shape, NPY_INT32)<br> 修改后使用： text<br> bytes_out = acl.util.ptr_to_bytes(ptr, size)<br> np_arr_out = np.frombuffer(bytes_out, dtype=np.int32).reshape(np_arr_in.shape)<br> - 若要继续使用该接口，需要运行环境为python ≥ 3.8且numpy ≥ 1.22.0。

父主题： Util模块

函数：bytes_to_ptr

C函数原型	无
Python函数	ptr = acl.util.bytes_to_ptr(data)
函数功能	将bytes对象转换成为void*数据，可以将转换好的数据传递给C函数直接使用。
输入说明	data：bytes类型数据。
返回值说明	ptr：int，可以被C语言访问的数据。
约束说明	该函数输入的生命周期需要大于输出的生命周期，否则可能会产生未定义行为。
注意事项	推荐使用acl.util.bytes_to_ptr替代acl.util.ptr_to_bytes。 修改示例： text<br>bytes_in = np_arr_in.tobytes()<br>bytes_ptr = acl.util.bytes_to_ptr(bytes_in)<br>

父主题： Util模块

函数：ptr_to_bytes

C函数原型	无
Python函数	bytes_out = acl.util.ptr_to_bytes(ptr, size)
函数功能	将void*数据转换为bytes对象，可以使python代码直接访问。
输入说明	ptr：int，C语言中的指针地址，能够访问的数据的首地址。 size：int，数据的大小，单位Byte。
返回值说明	bytes_out ：bytes对象。
约束说明	无
注意事项	由于acl.util.ptr_to_bytes会导致数据性能下降，建议使用函数：bytes_to_ptr。 text<br>bytes_out = acl.util.ptr_to_bytes(bytes_ptr, size)<br>

父主题： Util模块

函数：start_thread

C函数原型	无
Python函数	thr_id, ret = acl.util.start_thread(thr_func, args_list)
函数功能	创建线程，在线程中执行传入的Python函数。
输入说明	thr_func：Python函数对象，表示用户自定义的Python函数。 例如： python<br>def thr_func(args_list):<br>pass<br> args_list：list，表示用户自定义的python函数（thr_func）需要的传入参数。
返回值说明	thr_id：int，线程ID号。 ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。
约束说明	新建线程，无法自动获取Context，需要调用acl.rt.set_context接口显式指定Context。

父主题： thread

函数：stop_thread

C函数原型	无
Python函数	ret = acl.util.stop_thread(thr_id)
函数功能	等待由acl.util.start_thread接口创建的线程退出。
输入说明	thr_id：int，线程ID号。需指定由acl.util.start_thread接口获得的线程ID号。
返回值说明	ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。
约束说明	无

父主题： thread

函数：set_device

C函数原型	aclError aclrtSetDevice(int32_t deviceId)
Python函数	ret = acl.rt.set_device(device_id)
函数功能	指定当前进程或线程中用于运算的Device，同时隐式创建默认Context，同步接口。 对于Atlas 200/500 A2推理产品，该默认Context中包含1个默认Stream。
输入说明	device_id：int，Device设备号。 用户调用acl.rt.get_device_count接口获取可用的Device数量后，取值范围：[0, (可用的Device数量 - 1)]。
返回值说明	ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。
约束说明	如果多次调用acl.rt.set_device接口而不调用acl.rt.reset_device接口释放本进程使用的Device资源，功能上不会有问题，因为在进程退出时也会释放本进程使用的Device资源。建议acl.rt.set_device接口和acl.rt.reset_device接口配对使用，在不使用Device上资源时，通过调用acl.rt.reset_device接口及时释放本进程使用的Device资源。 支持以下使用场景： - 在不同进程或线程中支持调用acl.rt.set_device接口指定同一个Device用于运算。在同一个进程中的多个线程中，如果调用acl.rt.set_device接口指定同一个Device用于运算，这时隐式创建的默认Context是同一个。 - 在某一进程中指定Device，该进程内的多个线程可共用此Device显式创建Context（acl.rt.create_context接口）。 - 多Device场景下，可在进程中通过acl.rt.set_device接口切换到其它Device。但利用Context（调用acl.rt.set_context接口）来切换Device，比使用acl.rt.set_device接口效率高。
参考资源	接口调用流程与示例，请参见运行管理资源申请与释放、同步等待。

父主题： Device管理

在线提单