- Deprecated:
- This function is deprecated as of Cuda 3.0.
Sets the map flags for the buffer object specified by
buffer
.
Changes to Flags
will take effect the next time buffer
is mapped. The Flags
argument may be any of the following:
- CU_GL_MAP_RESOURCE_FLAGS_NONE: Specifies no hints about how this resource will be used. It is therefore assumed that this resource will be read from and written to by CUDA kernels. This is the default value.
- CU_GL_MAP_RESOURCE_FLAGS_READ_ONLY: Specifies that CUDA kernels which access this resource will not write to this resource.
- CU_GL_MAP_RESOURCE_FLAGS_WRITE_DISCARD: Specifies that CUDA kernels which access this resource will not read from this resource and will write over the entire contents of the resource, so none of the data previously stored in the resource will be preserved.
If buffer
has not been registered for use with CUDA, then CUDA_ERROR_INVALID_HANDLE is returned. If buffer
is presently mapped for access by CUDA, then CUDA_ERROR_ALREADY_MAPPED is returned.
There must be a valid OpenGL context bound to the current thread when this function is called. This must be the same context, or a member of the same shareGroup, as the context that was bound when the buffer was registered.
- Parameters:
-
| buffer | - Buffer object to unmap |
| Flags | - Map flags |
- Returns:
- CUDA_SUCCESS, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_ALREADY_MAPPED, CUDA_ERROR_INVALID_CONTEXT,
- Note:
- Note that this function may also return error codes from previous, asynchronous launches.
- See also:
- cuGraphicsResourceSetMapFlags