Function: device_disable_peer_access

Applicability

Product

Supported

Atlas 350 Accelerator Card

Atlas A3 training product/Atlas A3 inference product

Atlas A2 training product/Atlas A2 inference product

Atlas training product

Atlas inference product

Atlas 200I/500 A2 inference product

x

Description

Disables memory copy between the current device and a specified device. This API disables device-level memory copy.

Prototype

  • C Prototype
    aclError aclrtDeviceDisablePeerAccess(int32_t peerDeviceId)
  • Python Function
    1
    ret = acl.rt.device_disable_peer_access(peer_dev_id)
    

Parameters

Parameter

Description

peer_dev_id

Int, device ID, which must be different from the current device ID.

Must be in the range of [0, Device count – 1]. Call acl.rt.get_device_count to obtain the device count.

Return Value

Return Value

Description

ret

Int, error code. 0 on success; else, failure.

Restrictions

Call acl.rt.device_disable_peer_access twice to enable data exchange between two devices. For example, call acl.rt.device_enable_peer_access once to enable data exchange between device 0 and device 1, and call acl.rt.device_disable_peer_access again to enable data exchange between device 1 and device 0.