IDeviceContext

Description

Provides an abstraction layer for memory management, synchronization, and compute operations across different devices.

The IDeviceContext interface abstracts memory, synchronization, and compute operations for different compute devices such as CPU and GPU. It enables implementation-agnostic code while providing access to device-specific optimizations.

Unity provides concrete implementations of this interface including: - UnityEngine.LightTransport.RadeonRaysContext for GPU-accelerated operations using OpenCL 1.2.

The interface manages buffer allocation, asynchronous operations through events, and data transfer between host and device memory.

// Create and initialize a device context
using var context = new RadeonRaysContext();
bool initialized = context.Initialize();
Assert.IsTrue(initialized, "Failed to initialize context");

// Create a buffer and perform read/write operations
BufferID bufferId = context.CreateBuffer(1024, sizeof(int));
var bufferSlice = new BufferSlice<int>(bufferId, 0);

// Write data asynchronously
using var inputData = new NativeArray<int>(1024, Allocator.Persistent);
for (int i = 0; i < inputData.Length; i++)
    inputData[i] = i;

var writeEvent = context.CreateEvent();
context.WriteBuffer(bufferSlice, inputData, writeEvent);

// Read data back
using var outputData = new NativeArray<int>(1024, Allocator.Persistent);
var readEvent = context.CreateEvent();
context.ReadBuffer(bufferSlice, outputData, readEvent);

// Flush and wait for completion
context.Flush();
context.Wait(readEvent);

// Cleanup
context.DestroyEvent(writeEvent);
context.DestroyEvent(readEvent);
context.DestroyBuffer(bufferId);

Public Methods