Class KHRCreateCommandQueue
This extension allows OpenCL 1.x devices to support an equivalent of the CreateCommandQueueWithProperties API that was added in OpenCL 2.0. This
allows OpenCL 1.x devices to support other optional extensions or features that use the clCreateCommandQueueWithProperties API to specify
additional command queue properties that cannot be specified using the OpenCL 1.x clCreateCommandQueue API.
No new command queue properties are required by this extension. Applications may use the existing DEVICE_QUEUE_PROPERTIES query to determine command
queue properties that are supported by the device.
OpenCL 2.x devices may support this extension for compatibility. In this scenario, the function added by this extension will have the same capabilities
as the core clCreateCommandQueueWithProperties API. Applications that only target OpenCL 2.x devices should use the core OpenCL 2.x
clCreateCommandQueueWithProperties API instead of this extension API.
-
Method Summary
Modifier and TypeMethodDescriptionstatic longclCreateCommandQueueWithPropertiesKHR(long context, long device, long @Nullable [] properties, int @Nullable [] errcode_ret) Array version of:CreateCommandQueueWithPropertiesKHRstatic longclCreateCommandQueueWithPropertiesKHR(long context, long device, @Nullable LongBuffer properties, @Nullable IntBuffer errcode_ret) static longnclCreateCommandQueueWithPropertiesKHR(long context, long device, long properties, long errcode_ret) Unsafe version of:CreateCommandQueueWithPropertiesKHR
-
Method Details
-
nclCreateCommandQueueWithPropertiesKHR
public static long nclCreateCommandQueueWithPropertiesKHR(long context, long device, long properties, long errcode_ret) Unsafe version of:CreateCommandQueueWithPropertiesKHR -
clCreateCommandQueueWithPropertiesKHR
public static long clCreateCommandQueueWithPropertiesKHR(long context, long device, @Nullable LongBuffer properties, @Nullable IntBuffer errcode_ret) - Parameters:
context- a valid OpenCL contextdevice- a device associated with context. It can either be in the list of devices specified when context is created usingCreateContextor have the same device type as device type specified when context is created usingCreateContextFromType.properties- a list of properties for the command-queue and their corresponding values. Each property name is immediately followed by the corresponding desired value. The list is terminated with0. If a supported property and its value is not specified in properties, its default value will be used.propertiescan beNULLin which case the default values for supported command-queue properties will be used. Must be:QUEUE_PROPERTIESerrcode_ret- will return an appropriate error code. Iferrcode_retisNULL, no error code is returned.- Returns:
- a valid non-zero command-queue and
errcode_retis set toSUCCESSif the command-queue is created successfully. Otherwise, it returns aNULLvalue with one of the following error values returned inerrcode_ret:INVALID_CONTEXTifcontextis not a valid context.INVALID_DEVICEifdeviceis not a valid device or is not associated withcontext.INVALID_VALUEif values specified inpropertiesare not valid.INVALID_QUEUE_PROPERTIESif values specified inpropertiesare valid but are not supported by the device.OUT_OF_RESOURCESif there is a failure to allocate resources required by the OpenCL implementation on the device.OUT_OF_HOST_MEMORYif there is a failure to allocate resources required by the OpenCL implementation on the host.
-
clCreateCommandQueueWithPropertiesKHR
public static long clCreateCommandQueueWithPropertiesKHR(long context, long device, long @Nullable [] properties, int @Nullable [] errcode_ret) Array version of:CreateCommandQueueWithPropertiesKHR
-