Texture Reference Management

cudaBindTexture cudaBindTexture2D cudaBindTextureToArray cudaCreateChannelDesc cudaGetChannelDesc cudaGetTextureAlignmentOffset cudaGetTextureReference cudaUnbindTexture

cudaError_t cudaBindTexture2D ( size_t *  offset, const struct textureReference *  texref, const void *  devPtr, const struct cudaChannelFormatDesc *  desc, size_t  width, size_t  height, size_t  pitch   ) Binds the 2D memory area pointed to by devPtr to the texture reference texref. The size of the area is constrained by width in texel units, height in texel units, and pitch in byte units. desc describes how the memory is interpreted when fetching values from the texture. Any memory previously bound to texref is unbound. Since the hardware enforces an alignment requirement on texture base addresses, cudaBindTexture2D() returns in *offset a byte offset that must be applied to texture fetches in order to read from the desired memory. This offset must be divided by the texel size and passed to kernels that read from the texture so they can be applied to the tex2D() function. If the device memory pointer was returned from cudaMalloc(), the offset is guaranteed to be 0 and NULL may be passed as the offset parameter. Parameters: offset  - Offset in bytes texref  - Texture reference to bind devPtr  - 2D memory area on device desc  - Channel format width  - Width in texel units height  - Height in texel units pitch  - Pitch in bytes Returns: cudaSuccess, cudaErrorInvalidValue, cudaErrorInvalidDevicePointer, cudaErrorInvalidTexture Note: Note that this function may also return error codes from previous, asynchronous launches. See also: cudaCreateChannelDesc (C API), cudaGetChannelDesc, cudaGetTextureReference, cudaBindTexture (C API), cudaBindTexture2D (C++ API), cudaBindTexture2D (C++ API, inherited channel descriptor), cudaBindTextureToArray (C API), cudaBindTextureToArray (C API), cudaGetTextureAlignmentOffset (C API)