The accelerator extension consists of a unified set of OpenCL runtime APIs to create, query, and manage the lifetime of objects which represent
acceleration processors, engines, or algorithms. Accelerator object instances are referenced with the generic cl_accelerator_intel type by the runtime
API, but they are always associated with a specific acceleration engine type, which is assigned by the application at accelerator object creation time.
Descriptors are used to assign acceleration engine-specific properties to the accelerator objects. This mechanism of specialized creation with generic
referencing is analogous to the way image objects are managed in the OpenCL 1.2 runtime API via generic cl_mem referencing but specialized
descriptor-based creation with CreateImage.
Each accelerator object is assigned a unique type id. Vendors are freely encouraged to define new accelerator types and ids. This base extension provides unified mechanism for the creation and lifetime management of new accelerator types, but the semantics and creation descriptors of these types are to be defined in acceleration engine-specific extensions.
Accelerator objects can be supplied to kernels as arguments. Unless an extension defines a new OpenCL C language type for the engine-specific accelerator (e.g. sampler_t), accelerator objects can only be used in conjunction with built-in kernels. If an extension does define such a new type, or if it provides a mechanism to access accelerator data within kernels, then accelerator objects can act as regular kernel arguments as well.
Requires CL12.
| Modifier and Type | Field and Description |
|---|---|
| public static final int | CL_ACCELERATOR_CONTEXT_INTEL
Possible values for cl_accelerator_info_intel. |
| public static final int | CL_ACCELERATOR_DESCRIPTOR_INTEL
Possible values for cl_accelerator_info_intel. |
| public static final int | CL_ACCELERATOR_REFERENCE_COUNT_INTEL
Possible values for cl_accelerator_info_intel. |
| public static final int | CL_ACCELERATOR_TYPE_INTEL
Possible values for cl_accelerator_info_intel. |
| public static final int | CL_ACCELERATOR_TYPE_NOT_SUPPORTED_INTEL
Error codes used by functions in this extension. |
| public static final int | CL_INVALID_ACCELERATOR_DESCRIPTOR_INTEL
Error codes used by functions in this extension. |
| public static final int | CL_INVALID_ACCELERATOR_INTEL
Error codes used by functions in this extension. |
| public static final int | CL_INVALID_ACCELERATOR_TYPE_INTEL
Error codes used by functions in this extension. |
| Access | Constructor and Description |
|---|---|
| protected |
| Modifier and Type | Method and Description | ||||
|---|---|---|---|---|---|
| public static long | Returns: a valid non-zero accelerator object, anderrcode_ret is set to SUCCESS if the accelerator object is created successfully. Otherwise, it returns a
NULL value with one of the following error values returned in errcode_ret:
a valid OpenCL context context, int specifies the type of accelerator object created. The type constants are defined by acceleration engine-specific extensions. It is encouraged that
extensions follow the naming scheme of CL_ACCELERATOR_TYPE_{name}_INTEL where {name} is a descriptive acceleration engine string. accelerator_type, ByteBuffer a pointer to a structure that defines the parameter set of the accelerator object. This parameter set describes the configurable state of the
underlying object. The actual structure supplied must be consistent with descriptor, IntBuffer accelerator_type. The descriptor structures are defined by
acceleration engine-specific extensions. It is encouraged that extensions follow the naming scheme of cl_{name}_desc_INTEL where {name} is a
descriptive acceleration engine string.will return an appropriate error code. If errcode_ret)errcode_ret is NULL, no error code is returned.Accelerator objects represent the programmable state of an acceleration processor, engine, or algorithm. | ||||
| public static long | clCreateAcceleratorINTEL(long context, int accelerator_type, ByteBuffer descriptor, int[] errcode_ret)
Array version of: | ||||
| public static int | Returns: SUCCESS if the function is executed successfully. Otherwise, it returns one of the following errors:
the accelerator object being queried accelerator, int the information to query. One of: param_name, ByteBuffer
a pointer to memory where the appropriate result being queried is returned. If param_value, PointerBuffer param_value is NULL, it is ignored.the actual size in bytes of data being queried by param_value_size_ret)param_value. If NULL, it is ignored.Returns information about the accelerator object. | ||||
| public static int | Returns: SUCCESS if the function is executed successfully. Otherwise, it returns one of the following errors:
the accelerator object being queried accelerator, int the information to query. One of: param_name, IntBuffer
a pointer to memory where the appropriate result being queried is returned. If param_value, PointerBuffer param_value is NULL, it is ignored.the actual size in bytes of data being queried by param_value_size_ret)param_value. If NULL, it is ignored.Returns information about the accelerator object. | ||||
| public static int | Returns: SUCCESS if the function is executed successfully. Otherwise, it returns one of the following errors:
the accelerator object being queried accelerator, int the information to query. One of: param_name, PointerBuffer
a pointer to memory where the appropriate result being queried is returned. If param_value, PointerBuffer param_value is NULL, it is ignored.the actual size in bytes of data being queried by param_value_size_ret)param_value. If NULL, it is ignored.Returns information about the accelerator object. | ||||
| public static int | clGetAcceleratorInfoINTEL(long accelerator, int param_name, int[] param_value, PointerBuffer param_value_size_ret)
Array version of: | ||||
| public static int | Returns: SUCCESS if the function is executed successfully. Otherwise, it returns one of the following errors:
a valid accelerator object accelerator)Decrements the accelerator reference count. | ||||
| public static int | Returns: SUCCESS if the function is executed successfully. Otherwise, it returns one of the following errors:
a valid accelerator object accelerator)Increments the accelerator reference count. | ||||
| public static long | nclCreateAcceleratorINTEL(long context, int accelerator_type, long
a value which specifies of the size, in bytes, of the immediately following descriptor structure descriptor_size, long descriptor, long errcode_ret)Unsafe version of: | ||||
| public static int | nclGetAcceleratorInfoINTEL(long accelerator, int param_name, long
the size in bytes of memory pointed to by param_value_size, long param_value, long param_value_size_ret)param_value. This size must be ≥ size of return type. If param_value is NULL, it is ignored.Unsafe version of: |
| CL_ACCELERATOR_CONTEXT_INTEL | back to summary |
|---|---|
| public static final int CL_ACCELERATOR_CONTEXT_INTEL Possible values for cl_accelerator_info_intel. | |
| CL_ACCELERATOR_DESCRIPTOR_INTEL | back to summary |
|---|---|
| public static final int CL_ACCELERATOR_DESCRIPTOR_INTEL Possible values for cl_accelerator_info_intel. | |
| CL_ACCELERATOR_REFERENCE_COUNT_INTEL | back to summary |
|---|---|
| public static final int CL_ACCELERATOR_REFERENCE_COUNT_INTEL Possible values for cl_accelerator_info_intel. | |
| CL_ACCELERATOR_TYPE_INTEL | back to summary |
|---|---|
| public static final int CL_ACCELERATOR_TYPE_INTEL Possible values for cl_accelerator_info_intel. | |
| CL_ACCELERATOR_TYPE_NOT_SUPPORTED_INTEL | back to summary |
|---|---|
| public static final int CL_ACCELERATOR_TYPE_NOT_SUPPORTED_INTEL Error codes used by functions in this extension. | |
| CL_INVALID_ACCELERATOR_DESCRIPTOR_INTEL | back to summary |
|---|---|
| public static final int CL_INVALID_ACCELERATOR_DESCRIPTOR_INTEL Error codes used by functions in this extension. | |
| CL_INVALID_ACCELERATOR_INTEL | back to summary |
|---|---|
| public static final int CL_INVALID_ACCELERATOR_INTEL Error codes used by functions in this extension. | |
| CL_INVALID_ACCELERATOR_TYPE_INTEL | back to summary |
|---|---|
| public static final int CL_INVALID_ACCELERATOR_TYPE_INTEL Error codes used by functions in this extension. | |
| INTELAccelerator | back to summary |
|---|---|
| protected INTELAccelerator() | |
| clCreateAcceleratorINTEL | back to summary |
|---|---|
| public static long clCreateAcceleratorINTEL(long context, int accelerator_type, ByteBuffer descriptor, IntBuffer errcode_ret) Accelerator objects represent the programmable state of an acceleration processor, engine, or algorithm. Accelerator objects can be supplied to kernels as arguments. Unless an extension defines a new OpenCL C language type for the engine-specific accelerator (e.g. sampler_t), accelerator objects can only be used in conjunction with built-in kernels. This function creates an accelerator object. The accelerator object will be created with a reference count of one. Accelerator objects created with
this function have semantics defined by the parameter
| |
| clCreateAcceleratorINTEL | back to summary |
|---|---|
| public static long clCreateAcceleratorINTEL(long context, int accelerator_type, ByteBuffer descriptor, int[] errcode_ret) Array version of:
| |
| clGetAcceleratorInfoINTEL | back to summary | ||||
|---|---|---|---|---|---|
| public static int clGetAcceleratorInfoINTEL(long accelerator, int param_name, ByteBuffer param_value, PointerBuffer param_value_size_ret) Returns information about the accelerator object.
| |||||
| clGetAcceleratorInfoINTEL | back to summary | ||||
|---|---|---|---|---|---|
| public static int clGetAcceleratorInfoINTEL(long accelerator, int param_name, IntBuffer param_value, PointerBuffer param_value_size_ret) Returns information about the accelerator object.
| |||||
| clGetAcceleratorInfoINTEL | back to summary | ||||
|---|---|---|---|---|---|
| public static int clGetAcceleratorInfoINTEL(long accelerator, int param_name, PointerBuffer param_value, PointerBuffer param_value_size_ret) Returns information about the accelerator object.
| |||||
| clGetAcceleratorInfoINTEL | back to summary |
|---|---|
| public static int clGetAcceleratorInfoINTEL(long accelerator, int param_name, int[] param_value, PointerBuffer param_value_size_ret) Array version of:
| |
| clReleaseAcceleratorINTEL | back to summary |
|---|---|
| public static int clReleaseAcceleratorINTEL(long accelerator) Decrements the accelerator reference count. The accelerator object is deleted after the reference count becomes zero and commands queued for execution on a command-queue(s) that reference accelerator have finished.
| |
| clRetainAcceleratorINTEL | back to summary |
|---|---|
| public static int clRetainAcceleratorINTEL(long accelerator) Increments the accelerator reference count.
| |
| nclCreateAcceleratorINTEL | back to summary |
|---|---|
| public static long nclCreateAcceleratorINTEL(long context, int accelerator_type, long descriptor_size, long descriptor, long errcode_ret) Unsafe version of:
| |
| nclGetAcceleratorInfoINTEL | back to summary |
|---|---|
| public static int nclGetAcceleratorInfoINTEL(long accelerator, int param_name, long param_value_size, long param_value, long param_value_size_ret) Unsafe version of:
| |