Increments the memory object reference count.
cl_int clRetainMemObject(cl_mem memobj)clCreateBuffer, clCreateSubBuffer, clCreateImage, and clCreatePipe perform an implicit retain.
Returns CL_SUCCESS if the function is executed successfully.
Otherwise, it returns one of the following errors:
-
CL_INVALID_MEM_OBJECTifmemobjis a not a valid memory object (buffer or image object). -
CL_OUT_OF_RESOURCESif there is a failure to allocate resources required by the OpenCL implementation on the device. -
CL_OUT_OF_HOST_MEMORYif there is a failure to allocate resources required by the OpenCL implementation on the host.