Struct opencl3::device::Device

pub struct Device { /* fields omitted */ }

An OpenCL device id and methods to query it.
The query methods calls clGetDeviceInfo with the relevant param_name, see: Device Queries.

Implementations

impl Device

pub fn new(id: cl_device_id) -> Device

pub fn id(&self) -> cl_device_id

Accessor for the underlying device id.

pub fn create_sub_devices(
    &self,
    properties: &[cl_device_partition_property]
) -> Result<Vec<cl_device_id>, cl_int>

Create sub-devices by partitioning an OpenCL device.

• properties - the slice of cl_device_partition_property, see Subdevice Partition.

returns a Result containing a vector of available sub-device ids or the error code from the OpenCL C API function.

pub fn dev_type(&self) -> Result<cl_device_type, cl_int>

The OpenCL device type, see Device Types.

pub fn vendor_id(&self) -> Result<cl_uint, cl_int>

A unique device vendor identifier: a PCI vendor ID or a Khronos vendor ID if the vendor does not have a PCI vendor ID.

pub fn max_compute_units(&self) -> Result<cl_uint, cl_int>

The number of parallel compute units on the device, minimum 1.

pub fn max_work_item_dimensions(&self) -> Result<cl_uint, cl_int>

Maximum dimensions for global and local work-item IDs, minimum 3 if device is not CL_DEVICE_TYPE_CUSTOM.

pub fn max_work_group_size(&self) -> Result<size_t, cl_int>

Maximum number of work-items for each dimension of a work-group, minimum [1, 1, 1] if device is not CL_DEVICE_TYPE_CUSTOM.

pub fn max_work_item_sizes(&self) -> Result<Vec<size_t>, cl_int>

pub fn max_preferred_vector_width_char(&self) -> Result<cl_uint, cl_int>

pub fn max_preferred_vector_width_short(&self) -> Result<cl_uint, cl_int>

pub fn max_preferred_vector_width_int(&self) -> Result<cl_uint, cl_int>

pub fn max_preferred_vector_width_long(&self) -> Result<cl_uint, cl_int>

pub fn max_preferred_vector_width_float(&self) -> Result<cl_uint, cl_int>

pub fn max_preferred_vector_width_double(&self) -> Result<cl_uint, cl_int>

pub fn max_clock_frequency(&self) -> Result<cl_uint, cl_int>

pub fn address_bits(&self) -> Result<cl_uint, cl_int>

pub fn max_read_image_args(&self) -> Result<cl_uint, cl_int>

pub fn max_write_image_args(&self) -> Result<cl_uint, cl_int>

pub fn max_mem_alloc_size(&self) -> Result<cl_ulong, cl_int>

pub fn image2d_max_width(&self) -> Result<size_t, cl_int>

pub fn image2d_max_height(&self) -> Result<size_t, cl_int>

pub fn image3d_max_width(&self) -> Result<size_t, cl_int>

pub fn image3d_max_height(&self) -> Result<size_t, cl_int>

pub fn image3d_max_depth(&self) -> Result<size_t, cl_int>

pub fn image_support(&self) -> Result<cl_uint, cl_int>

pub fn max_parameter_size(&self) -> Result<size_t, cl_int>

pub fn max_device_samples(&self) -> Result<cl_uint, cl_int>

pub fn mem_base_addr_align(&self) -> Result<cl_uint, cl_int>

pub fn min_data_type_align_size(&self) -> Result<cl_uint, cl_int>

pub fn single_fp_config(&self) -> Result<cl_ulong, cl_int>

pub fn global_mem_cache_type(&self) -> Result<cl_uint, cl_int>

pub fn global_mem_cacheline_size(&self) -> Result<cl_uint, cl_int>

pub fn global_mem_cache_size(&self) -> Result<cl_ulong, cl_int>

pub fn global_mem_size(&self) -> Result<cl_ulong, cl_int>

pub fn max_constant_buffer_size(&self) -> Result<cl_ulong, cl_int>

pub fn max_constant_args(&self) -> Result<cl_uint, cl_int>

pub fn local_mem_type(&self) -> Result<cl_uint, cl_int>

pub fn local_mem_size(&self) -> Result<cl_ulong, cl_int>

pub fn error_correction_support(&self) -> Result<cl_uint, cl_int>

pub fn profiling_timer_resolution(&self) -> Result<size_t, cl_int>

pub fn endian_little(&self) -> Result<cl_uint, cl_int>

pub fn available(&self) -> Result<cl_uint, cl_int>

pub fn compiler_available(&self) -> Result<cl_uint, cl_int>

pub fn execution_capabilities(&self) -> Result<cl_ulong, cl_int>

pub fn queue_on_host_properties(&self) -> Result<cl_ulong, cl_int>

pub fn name(&self) -> Result<CString, cl_int>

pub fn vendor(&self) -> Result<CString, cl_int>

pub fn driver_version(&self) -> Result<CString, cl_int>

pub fn profile(&self) -> Result<CString, cl_int>

pub fn version(&self) -> Result<CString, cl_int>

pub fn extensions(&self) -> Result<CString, cl_int>

pub fn platform(&self) -> Result<intptr_t, cl_int>

pub fn double_fp_config(&self) -> Result<cl_ulong, cl_int>

pub fn half_fp_config(&self) -> Result<cl_ulong, cl_int>

pub fn preferred_vector_width_half(&self) -> Result<cl_uint, cl_int>

pub fn host_unified_memory(&self) -> Result<cl_uint, cl_int>

pub fn native_vector_width_char(&self) -> Result<cl_uint, cl_int>

pub fn native_vector_width_short(&self) -> Result<cl_uint, cl_int>

pub fn native_vector_width_int(&self) -> Result<cl_uint, cl_int>

pub fn native_vector_width_long(&self) -> Result<cl_uint, cl_int>

pub fn native_vector_width_float(&self) -> Result<cl_uint, cl_int>

pub fn native_vector_width_double(&self) -> Result<cl_uint, cl_int>

pub fn native_vector_width_half(&self) -> Result<cl_uint, cl_int>

pub fn opencl_c_version(&self) -> Result<CString, cl_int>

pub fn linker_available(&self) -> Result<cl_uint, cl_int>

pub fn built_in_kernels(&self) -> Result<CString, cl_int>

pub fn image_max_buffer_size(&self) -> Result<size_t, cl_int>

pub fn image_max_array_size(&self) -> Result<size_t, cl_int>

pub fn parent_device(&self) -> Result<intptr_t, cl_int>

pub fn partition_max_sub_devices(&self) -> Result<cl_uint, cl_int>

pub fn partition_properties(&self) -> Result<Vec<intptr_t>, cl_int>

pub fn partition_affinity_domain(&self) -> Result<Vec<cl_ulong>, cl_int>

pub fn partition_type(&self) -> Result<Vec<intptr_t>, cl_int>

pub fn reference_count(&self) -> Result<cl_uint, cl_int>

pub fn preferred_interop_user_sync(&self) -> Result<cl_uint, cl_int>

pub fn printf_buffer_size(&self) -> Result<size_t, cl_int>

pub fn image_pitch_alignment(&self) -> Result<cl_uint, cl_int>

pub fn image_base_address_alignment(&self) -> Result<cl_uint, cl_int>

pub fn max_read_write_image_args(&self) -> Result<cl_uint, cl_int>

pub fn max_global_variable_size(&self) -> Result<size_t, cl_int>

pub fn queue_on_device_properties(&self) -> Result<Vec<intptr_t>, cl_int>

pub fn queue_on_device_preferred_size(&self) -> Result<size_t, cl_int>

pub fn queue_on_device_max_size(&self) -> Result<size_t, cl_int>

pub fn max_on_device_queues(&self) -> Result<cl_uint, cl_int>

pub fn max_on_device_events(&self) -> Result<cl_uint, cl_int>

pub fn svm_capabilities(&self) -> Result<cl_device_svm_capabilities, cl_int>

pub fn global_variable_preferred_total_size(&self) -> Result<size_t, cl_int>

pub fn max_pipe_args(&self) -> Result<cl_uint, cl_int>

pub fn pipe_max_active_reservations(&self) -> Result<cl_uint, cl_int>

pub fn pipe_max_packet_size(&self) -> Result<cl_uint, cl_int>

pub fn preferred_platform_atomic_alignment(&self) -> Result<cl_uint, cl_int>

pub fn preferred_global_atomic_alignment(&self) -> Result<cl_uint, cl_int>

pub fn preferred_local_atomic_alignment(&self) -> Result<cl_uint, cl_int>

pub fn il_version(&self) -> Result<CString, cl_int>

pub fn max_num_sub_groups(&self) -> Result<cl_uint, cl_int>

pub fn sub_group_independent_forward_progress(&self) -> Result<cl_uint, cl_int>

pub fn numeric_version(&self) -> Result<cl_uint, cl_int>

pub fn extensions_with_version(&self) -> Result<Vec<cl_name_version>, cl_int>

pub fn ils_with_version(&self) -> Result<Vec<cl_name_version>, cl_int>

pub fn built_in_kernels_with_version(
    &self
) -> Result<Vec<cl_name_version>, cl_int>

pub fn atomic_memory_capabilities(&self) -> Result<cl_ulong, cl_int>

pub fn atomic_fence_capabilities(&self) -> Result<cl_ulong, cl_int>

pub fn non_uniform_work_group_support(&self) -> Result<cl_uint, cl_int>

pub fn opencl_c_all_versions(&self) -> Result<Vec<cl_name_version>, cl_int>

pub fn preferred_work_group_size_multiple(&self) -> Result<size_t, cl_int>

pub fn work_group_collective_functions_support(&self) -> Result<cl_uint, cl_int>

pub fn generic_address_space_support(&self) -> Result<cl_uint, cl_int>

pub fn opencl_c_features(&self) -> Result<Vec<cl_name_version>, cl_int>

pub fn device_enqueue_capabilities(&self) -> Result<cl_ulong, cl_int>

pub fn pipe_support(&self) -> Result<cl_uint, cl_int>

pub fn latest_conformance_version_passed(&self) -> Result<CString, cl_int>

pub fn supports_half(&self, min_fp_capability: cl_device_fp_config) -> bool

Determine if the device supports the given half floating point capability.
Returns true if the device supports it, false otherwise.

pub fn supports_double(&self, min_fp_capability: cl_device_fp_config) -> bool

Determine if the device supports the given double floating point capability.
Returns true if the device supports it, false otherwise.

pub fn svm_mem_capability(&self) -> cl_device_svm_capabilities

Determine if the device supports SVM and, if so, what kind of SVM.
Returns zero if the device does not support SVM.