Class CudaCompiledRingKernel

Namespace

DotCompute.Backends.CUDA.RingKernels

Assembly

DotCompute.Backends.CUDA.dll

Represents a compiled Ring Kernel with PTX module and function pointer.

public sealed class CudaCompiledRingKernel : CompiledKernel, IDisposable

Inheritance

object

CompiledKernel

CudaCompiledRingKernel

Implements

IDisposable

Inherited Members

CompiledKernel.Name

CompiledKernel.Id

CompiledKernel.CompiledBinary

CompiledKernel.Metadata

CompiledKernel.IsDisposed

CompiledKernel.Ptx

CompiledKernel.Cubin

CompiledKernel.Binary

CompiledKernel.ComputeCapability

CompiledKernel.CompilationTime

CompiledKernel.CompiledAt

CompiledKernel.EntryPoint

CompiledKernel.TargetDevice

CompiledKernel.RequiredSharedMemory

CompiledKernel.MaxThreadsPerBlock

CompiledKernel.ExecuteAsync(KernelArguments, CancellationToken)

CompiledKernel.Dispose()

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods

BufferExtensions.IsSafeToDispose(IDisposable)

BufferExtensions.SafeDispose(IDisposable)

Remarks

This class extends CompiledKernel with Ring Kernel-specific metadata including the discovered kernel information, PTX module handle, and kernel function pointer.

Lifecycle:

1. Created by CudaRingKernelCompiler after successful compilation
2. PTX module loaded into CUDA context
3. Function pointer retrieved for cooperative kernel launch
4. Module unloaded on disposal

Constructors

CudaCompiledRingKernel(DiscoveredRingKernel, nint, nint, ReadOnlyMemory<byte>, nint)

Initializes a new instance of the CudaCompiledRingKernel class.

public CudaCompiledRingKernel(DiscoveredRingKernel discoveredKernel, nint moduleHandle, nint functionPointer, ReadOnlyMemory<byte> ptxBytes, nint cudaContext)

Parameters

discoveredKernel DiscoveredRingKernel

The discovered kernel metadata.

moduleHandle nint

The PTX module handle.

functionPointer nint

The kernel function pointer.

ptxBytes ReadOnlyMemory<byte>

The PTX source code bytes.

cudaContext nint

The CUDA context.

Properties

CompilationTimestamp

Gets the compilation timestamp.

public DateTime CompilationTimestamp { get; }

Property Value

DateTime

CudaContext

Gets the CUDA context this kernel was compiled for.

public nint CudaContext { get; }

Property Value

nint

DiscoveredKernel

Gets the discovered kernel metadata from reflection.

public DiscoveredRingKernel DiscoveredKernel { get; }

Property Value

DiscoveredRingKernel

FunctionPointer

Gets the kernel function pointer for cooperative launch.

public nint FunctionPointer { get; }

Property Value

nint

IsValid

Gets a value indicating whether this kernel is valid for execution.

public bool IsValid { get; }

Property Value

bool

ModuleHandle

Gets the PTX module handle.

public nint ModuleHandle { get; }

Property Value

nint

PtxBytes

Gets the PTX source code bytes.

public ReadOnlyMemory<byte> PtxBytes { get; }

Property Value

ReadOnlyMemory<byte>

Methods

Dispose(bool)

Releases the unmanaged resources used by the CompiledKernel and optionally releases the managed resources.

protected override void Dispose(bool disposing)

Parameters

disposing bool

True to release both managed and unmanaged resources; false to release only unmanaged resources.

Remarks

This method is called by the Dispose() method and the finalizer. Override this method in derived classes to provide specific resource cleanup logic.