cudaCreateSurfaceObject (3)

NAME

Surface Object Management -

Functions

cudaError_t cudaCreateSurfaceObject (cudaSurfaceObject_t *pSurfObject, const struct cudaResourceDesc *pResDesc)
Creates a surface object.
cudaError_t cudaDestroySurfaceObject (cudaSurfaceObject_t surfObject)
Destroys a surface object.
cudaError_t cudaGetSurfaceObjectResourceDesc (struct cudaResourceDesc *pResDesc, cudaSurfaceObject_t surfObject)
Returns a surface object's resource descriptor Returns the resource descriptor for the surface object specified by surfObject.

Detailed Description

\brief surface object management functions of the CUDA runtime API (cuda_runtime_api.h)

This section describes the low level texture object management functions of the CUDA runtime application programming interface. The surface object API is only supported on devices of compute capability 3.0 or higher.

Function Documentation

cudaError_t cudaCreateSurfaceObject (cudaSurfaceObject_t * pSurfObject, const struct cudaResourceDesc * pResDesc)

Creates a surface object and returns it in pSurfObject. pResDesc describes the data to perform surface load/stores on. cudaResourceDesc::resType must be cudaResourceTypeArray and cudaResourceDesc::res::array::array must be set to a valid CUDA array handle.

Surface objects are only supported on devices of compute capability 3.0 or higher. Additionally, a surface object is an opaque value, and, as such, should only be accessed through CUDA API calls.

Parameters:

pSurfObject - Surface object to create
pResDesc - Resource descriptor

Returns:

cudaSuccess, cudaErrorInvalidValue

See also:

cudaDestroySurfaceObject

cudaError_t cudaDestroySurfaceObject (cudaSurfaceObject_t surfObject)

Destroys the surface object specified by surfObject.

Parameters:

surfObject - Surface object to destroy

Returns:

cudaSuccess, cudaErrorInvalidValue

See also:

cudaCreateSurfaceObject

cudaError_t cudaGetSurfaceObjectResourceDesc (struct cudaResourceDesc * pResDesc, cudaSurfaceObject_t surfObject)

Parameters:

pResDesc - Resource descriptor
surfObject - Surface object

Returns:

cudaSuccess, cudaErrorInvalidValue

See also:

cudaCreateSurfaceObject

Author

Generated automatically by Doxygen from the source code.