Struct Context

Source

pub struct Context { /* private fields */ }

Implementations§

Source §

impl Context

Source

pub fn new(device: Device) -> CudaResult<Self>

Retains the primary context for this device and makes it current, incrementing the internal reference cycle that CUDA keeps track of. There is only one primary context associated with a device, multiple calls to this function with the same device will return the same internal context.

This will NOT push the context to the stack, primary contexts do not interoperate with the context stack.

Source

pub unsafe fn reset(device: &Device) -> CudaResult<()>

Resets the primary context associated with the device, freeing all allocations created inside of the context. You must make sure that nothing else is using the context or using CUDA on the device in general. For this reason, it is usually highly advised to not use this function.

§Safety

Nothing else should be using the primary context for this device, otherwise, spurious errors or segfaults will occur.

Source

pub fn set_flags(&self, flags: ContextFlags) -> CudaResult<()>

Sets the flags for the device context, these flags will apply to any user of the primary context associated with this device.

Source

pub fn as_raw(&self) -> CUcontext

Returns the raw handle to this context.

Source

pub fn get_api_version(&self) -> CudaResult<CudaApiVersion>

Get the API version used to create this context.

This is not necessarily the latest version supported by the driver.

§Example

cust::init(cust::CudaFlags::empty())?;
let device = Device::get_device(0)?;
let context = Context::new(device)?;
let version = context.get_api_version()?;

Source

pub fn drop(ctx: Context) -> DropResult<Context>

Destroy a Context, returning an error.

Destroying a context can return errors from previous asynchronous work. This function destroys the given context and returns the error and the un-destroyed context on failure.

§Example

let context = Context::new(device)?;
match Context::drop(context) {
    Ok(()) => println!("Successfully destroyed"),
    Err((e, ctx)) => {
        println!("Failed to destroy context: {:?}", e);
        // Do something with ctx
    },
}