4.20. Surface Reference Management

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

Functions

CUresult cuSurfRefGetArray ( CUarray* phArray, CUsurfref hSurfRef )
Passes back the CUDA array bound to a surface reference.
CUresult cuSurfRefSetArray ( CUsurfref hSurfRef, CUarray hArray, unsigned int  Flags )
Sets the CUDA array for a surface reference.

Functions

CUresult cuSurfRefGetArray ( CUarray* phArray, CUsurfref hSurfRef )
Passes back the CUDA array bound to a surface reference.
Parameters
phArray
- Surface reference handle
hSurfRef
- Surface reference handle
Description

Returns in *phArray the CUDA array bound to the surface reference hSurfRef, or returns CUDA_ERROR_INVALID_VALUE if the surface reference is not bound to any CUDA array.

See also:

cuModuleGetSurfRef, cuSurfRefSetArray

CUresult cuSurfRefSetArray ( CUsurfref hSurfRef, CUarray hArray, unsigned int  Flags )
Sets the CUDA array for a surface reference.
Parameters
hSurfRef
- Surface reference handle
hArray
- CUDA array handle
Flags
- set to 0
Description

Sets the CUDA array hArray to be read and written by the surface reference hSurfRef. Any previous CUDA array state associated with the surface reference is superseded by this function. Flags must be set to 0. The CUDA_ARRAY3D_SURFACE_LDST flag must have been set for the CUDA array. Any CUDA array previously bound to hSurfRef is unbound.

See also:

cuModuleGetSurfRef, cuSurfRefGetArray, cudaBindSurfaceToArray