Class CommandQueueOptions

Namespace

Orleans.GpuBridge.Abstractions.Models

Assembly

Orleans.GpuBridge.Abstractions.dll

Configuration options for creating a command queue. These options control the behavior and capabilities of the command queue, including profiling, execution ordering, and priority settings.

public sealed record CommandQueueOptions : IEquatable<CommandQueueOptions>

Inheritance

object

CommandQueueOptions

Implements

IEquatable<CommandQueueOptions>

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Constructors

CommandQueueOptions(bool, bool, int)

Configuration options for creating a command queue. These options control the behavior and capabilities of the command queue, including profiling, execution ordering, and priority settings.

public CommandQueueOptions(bool EnableProfiling = false, bool EnableOutOfOrderExecution = false, int Priority = 0)

Parameters

EnableProfiling bool

Indicates whether profiling should be enabled for operations submitted to this queue. When enabled, the queue will collect detailed timing and performance metrics for each kernel execution and memory operation. This information can be used for performance analysis and optimization but may introduce slight overhead. Default is false.

EnableOutOfOrderExecution bool

Indicates whether out-of-order execution should be enabled for this queue. When enabled, operations in the queue may complete in a different order than they were submitted, potentially improving throughput through better resource utilization. Applications must use proper synchronization mechanisms (such as barriers) when order dependencies exist. Default is false.

Priority int

The priority level for this command queue relative to other queues. Higher values indicate higher priority, which may influence scheduling decisions when multiple queues are competing for device resources. The exact behavior and supported range depends on the backend implementation. Default is 0 (normal priority).

Properties

EnableOutOfOrderExecution

Indicates whether out-of-order execution should be enabled for this queue. When enabled, operations in the queue may complete in a different order than they were submitted, potentially improving throughput through better resource utilization. Applications must use proper synchronization mechanisms (such as barriers) when order dependencies exist. Default is false.

public bool EnableOutOfOrderExecution { get; init; }

Property Value

bool

EnableProfiling

Indicates whether profiling should be enabled for operations submitted to this queue. When enabled, the queue will collect detailed timing and performance metrics for each kernel execution and memory operation. This information can be used for performance analysis and optimization but may introduce slight overhead. Default is false.

public bool EnableProfiling { get; init; }

Property Value

bool

Priority

The priority level for this command queue relative to other queues. Higher values indicate higher priority, which may influence scheduling decisions when multiple queues are competing for device resources. The exact behavior and supported range depends on the backend implementation. Default is 0 (normal priority).

public int Priority { get; init; }

Property Value

int