Increments the sampler reference count.

cl_int clRetainSampler(cl_sampler sampler)

Parameters

sampler

Specifies the sampler being retained.

Notes

clCreateSamplerWithProperties performs an implicit retain.

Errors

Returns CL_SUCCESS if the function is executed successfully. Otherwise, it returns one of the following errors:

  • CL_INVALID_SAMPLER if sampler is not a valid sampler object.

  • CL_OUT_OF_RESOURCES if there is a failure to allocate resources required by the OpenCL implementation on the device.

  • CL_OUT_OF_HOST_MEMORY if there is a failure to allocate resources required by the OpenCL implementation on the host.

Also see

Specification