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

Returns

cudaSuccess, cudaErrorInvalidValue, cudaErrorInvalidSurface

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:

• Note that this function may also return error codes from previous, asynchronous launches.

• Note that this function may also return cudaErrorInitializationError, cudaErrorInsufficientDriver or cudaErrorNoDevice if this call tries to initialize internal CUDA RT state.

• Note that as specified by cudaStreamAddCallback no CUDA function may be called from callback. cudaErrorNotPermitted may, but is not guaranteed to, be returned as a diagnostic in such case.

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

Returns

cudaSuccess, cudaErrorInvalidSurface

Deprecated

Description

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

Note:

• Note that this function may also return error codes from previous, asynchronous launches.

• Use of a string naming a variable as the symbol parameter was removed in CUDA 5.0.

• Note that this function may also return cudaErrorInitializationError, cudaErrorInsufficientDriver or cudaErrorNoDevice if this call tries to initialize internal CUDA RT state.

• Note that as specified by cudaStreamAddCallback no CUDA function may be called from callback. cudaErrorNotPermitted may, but is not guaranteed to, be returned as a diagnostic in such case.

See also:

cudaBindSurfaceToArray ( C API), cuModuleGetSurfRef