void
clSVMFree
(
| cl_context context, |
void *svm_pointer) |
Parameters
-
context -
A valid OpenCL context used to create the SVM buffer.
-
svm_pointer -
Must be the value returned by a call to clSVMAlloc. If a NULL pointer is passed in
svm_pointer, no action occurs.
Notes
Note that clSVMFree does not wait
for previously enqueued commands that may be using
svm_pointer to finish before freeing
svm_pointer. It is the responsibility
of the application to
make sure that enqueued commands that use
svm_pointer have finished before freeing
svm_pointer. This can be done by
enqueuing a blocking operation such as
clFinish,
clWaitForEvents,
clEnqueueReadBuffer
or by registering a callback with the events
associated with enqueued commands and when the
last enqueued comamnd has finished freeing
svm_pointer.
The behavior of using svm_pointer after
it has been freed is undefined. In addition, if a buffer
object is created using
clCreateBuffer
with svm_pointer, the buffer object must first be released
before the svm_pointer is freed.
The clEnqueueSVMFree API can also be used to enqueue a callback to free the shared virtual memory buffer allocated using clSVMAlloc or a shared system memory pointer.
Copyright © 2007-2013 The Khronos Group Inc.
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and/or associated documentation files (the
"Materials"), to deal in the Materials without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Materials, and to
permit persons to whom the Materials are furnished to do so, subject to
the condition that this copyright notice and permission notice shall be included
in all copies or substantial portions of the Materials.