Struct DeviceBuffer 

pub struct DeviceBuffer<T: Copy> { /* private fields */ }

A contiguous buffer of T elements allocated in GPU device memory.

The buffer owns the underlying CUdeviceptr allocation and frees it on drop. All copy operations validate that source and destination lengths match, returning CudaError::InvalidValue on mismatch.

Implementations

impl<T: Copy> DeviceBuffer<T>

pub fn view_as<U: Copy>(&self) -> CudaResult<BufferView<'_, U>>

Reinterprets this buffer as a different element type U (immutable).

The total byte size of the buffer must be evenly divisible by size_of::<U>(). The resulting view has byte_size / size_of::<U>() elements.

Errors

Returns CudaError::InvalidValue if:

• size_of::<U>() is zero (ZST).
• The buffer’s byte size is not divisible by size_of::<U>().

pub fn view_as_mut<U: Copy>(&mut self) -> CudaResult<BufferViewMut<'_, U>>

Reinterprets this buffer as a different element type U (mutable).

The total byte size of the buffer must be evenly divisible by size_of::<U>(). The resulting view has byte_size / size_of::<U>() elements.

Errors

Returns CudaError::InvalidValue if:

• size_of::<U>() is zero (ZST).
• The buffer’s byte size is not divisible by size_of::<U>().

impl<T: Copy> DeviceBuffer<T>

pub fn alloc(n: usize) -> CudaResult<Self>

Allocates a device buffer capable of holding n elements of type T.

Errors

• CudaError::InvalidValue if n is zero.
• CudaError::OutOfMemory if the GPU cannot satisfy the request.
• Other driver errors propagated from cuMemAlloc_v2.

pub fn zeroed(n: usize) -> CudaResult<Self>

Allocates a device buffer of n elements and zero-initialises every byte.

This is equivalent to alloc followed by a cuMemsetD8_v2 call that writes 0 to every byte.

Errors

Same as alloc, plus any error from cuMemsetD8_v2.

pub fn from_host(data: &[T]) -> CudaResult<Self>

Allocates a device buffer and copies the contents of data into it.

The resulting buffer has the same length as the input slice.

Errors

• CudaError::InvalidValue if data is empty.
• Other driver errors from allocation or the host-to-device copy.

pub fn copy_from_host(&mut self, src: &[T]) -> CudaResult<()>

Copies data from a host slice into this device buffer (synchronous).

The slice length must exactly match the buffer length.

Errors

• CudaError::InvalidValue if src.len() != self.len().
• Other driver errors from cuMemcpyHtoD_v2.

pub fn copy_to_host(&self, dst: &mut [T]) -> CudaResult<()>

Copies this device buffer’s contents into a host slice (synchronous).

The slice length must exactly match the buffer length.

Errors

• CudaError::InvalidValue if dst.len() != self.len().
• Other driver errors from cuMemcpyDtoH_v2.

pub fn copy_from_device(&mut self, src: &DeviceBuffer<T>) -> CudaResult<()>

Copies the entire contents of another device buffer into this one.

Both buffers must have the same length.

Errors

• CudaError::InvalidValue if src.len() != self.len().
• Other driver errors from cuMemcpyDtoD_v2.

pub fn copy_from_host_async( &mut self, src: &[T], stream: &Stream, ) -> CudaResult<()>

Asynchronously copies data from a host slice into this device buffer.

The copy is enqueued on stream and may not be complete when this function returns. The caller must ensure that src remains valid (i.e., is not moved or dropped) until the stream has been synchronised. For guaranteed correctness, prefer using a PinnedBuffer as the source.

Errors

• CudaError::InvalidValue if src.len() != self.len().
• Other driver errors from cuMemcpyHtoDAsync_v2.

pub fn copy_to_host_async( &self, dst: &mut [T], stream: &Stream, ) -> CudaResult<()>

Asynchronously copies this device buffer’s contents into a host slice.

The copy is enqueued on stream and may not be complete when this function returns. The caller must ensure that dst remains valid and is not read until the stream has been synchronised. For guaranteed correctness, prefer using a PinnedBuffer as the destination.

Errors

• CudaError::InvalidValue if dst.len() != self.len().
• Other driver errors from cuMemcpyDtoHAsync_v2.

pub fn len(&self) -> usize

Returns the number of T elements in this buffer.

pub fn is_empty(&self) -> bool

Returns true if the buffer contains zero elements.

In practice this is always false because alloc rejects zero-length allocations.

pub fn byte_size(&self) -> usize

Returns the total size of the allocation in bytes.

pub fn as_device_ptr(&self) -> CUdeviceptr

Returns the raw CUdeviceptr handle for this buffer.

This is useful when passing the pointer to kernel launch parameters or other low-level driver calls.

pub fn slice(&self, offset: usize, len: usize) -> CudaResult<DeviceSlice<'_, T>>

Returns a borrowed DeviceSlice referencing a sub-range of this buffer starting at element offset and spanning len elements.

Errors

Returns CudaError::InvalidValue if the requested range exceeds the buffer bounds (i.e., offset + len > self.len()).

Trait Implementations

impl<T: Copy> Drop for DeviceBuffer<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: Copy + Send> Send for DeviceBuffer<T>

impl<T: Copy + Sync> Sync for DeviceBuffer<T>