Function: device_disable_peer_access

Applicability

Product

Supported (√/x)

Atlas A3 training products/Atlas A3 inference products

Atlas A2 training products/Atlas A2 inference products

Atlas training products

Atlas inference products

Atlas 200I/500 A2 inference products

x

Function Usage

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)
    

Parameter Description

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 Description

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.