5.25. Surface Reference Management [DEPRECATED]

This section describes the low level surface reference management functions of the CUDA runtime application programming interface.

Some functions have overloaded C++ API template versions documented separately in the C++ API Routines module.

Functions

__host__cudaError_t cudaBindSurfaceToArray ( const surfaceReference* surfref, cudaArray_const_t array, const cudaChannelFormatDesc* desc )
Binds an array to a surface.
__host__cudaError_t cudaGetSurfaceReference ( const surfaceReference** surfref, const void* symbol )
Get the surface reference associated with a symbol.

Functions

__host__cudaError_t cudaBindSurfaceToArray ( const surfaceReference* surfref, cudaArray_const_t array, const cudaChannelFormatDesc* desc )
Binds an array to a surface.
Parameters
surfref
- Surface to bind
array
- Memory array on device
desc
- Channel format
Deprecated

Description
Binds the CUDA array array to the surface reference surfref. desc describes how the memory is interpreted when fetching values from the surface. Any CUDA array previously bound to surfref is unbound.

Note:

See also:

cudaBindSurfaceToArray ( C++ API), cudaBindSurfaceToArray ( C++ API, inherited channel descriptor), cudaGetSurfaceReference, cuSurfRefSetArray

__host__cudaError_t cudaGetSurfaceReference ( const surfaceReference** surfref, const void* symbol )
Get the surface reference associated with a symbol.
Parameters
surfref
- Surface reference associated with symbol
symbol
- Surface to get reference for
Deprecated

Description
Returns in *surfref the structure associated to the surface reference defined by symbol symbol.

Note:

See also:

cudaBindSurfaceToArray ( C API), cuModuleGetSurfRef