Struct PrimaryContext 

pub struct PrimaryContext { /* private fields */ }

A retained reference to a device’s primary context — the one shared with the CUDA Runtime API (cudart). Use this when you need to mix driver-API kernels/streams with framework code that relies on the runtime API (most ML frameworks do).

Each PrimaryContext::retain bumps a refcount on the device’s primary context; Drop calls cuDevicePrimaryCtxRelease. The context itself is destroyed when the refcount hits zero.

Implementations

impl PrimaryContext

pub fn retain(device: &Device) -> Result<Self>

Increment the refcount on device’s primary context and return a handle to it. Equivalent to cuDevicePrimaryCtxRetain.

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

Forcibly destroy the primary context on device, releasing all resources and resetting refcounts. Any outstanding handles returned by retain become dangling — only call this when you know nobody else (Runtime API, other libraries) is using the primary context. Equivalent to cuDevicePrimaryCtxReset.

pub fn device(&self) -> Device

Underlying device.

pub fn as_raw(&self) -> CUcontext

Raw CUcontext — same handle the Runtime API would use.

Trait Implementations

impl Debug for PrimaryContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for PrimaryContext

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Send for PrimaryContext

impl Sync for PrimaryContext