dpctl.memory.IPCMemoryHandle.open

static IPCMemoryHandle.open(handle_bytes, device, nbytes)

Open an IPC handle in this process.

Parameters:

  • handle_bytes (bytes) – Opaque payload from to_bytes() (possibly from another process).

  • device (dpctl.SyclDevice) – Device to map the memory on.

  • nbytes (int) – Byte size of the original allocation. Must be > 0.

Returns:

A USM device memory object backed by the IPC-mapped pointer. Call close_mapping() when done.

Return type:

MemoryIPCDevice

Raises:

  • RuntimeError – If the device does not support IPC memory or the handle cannot be opened.

  • ValueError – If nbytes <= 0.