cuda.bindings._v2.driver.tex_ref_set_address2d_v3#

cuda.bindings._v2.driver.tex_ref_set_address2d_v3( intptr_t h_tex_ref, desc, uint64_t dptr, size_t pitch, )#

Binds an address as a 2D texture reference.

[Deprecated]. Binds a linear address range to the texture reference h_tex_ref. Any previous address or CUDA array state associated with the texture reference is superseded by this function. Any memory previously bound to h_tex_ref is unbound. Using a tex2D() function inside a kernel requires a call to either tex_ref_set_array() to bind the corresponding texture reference to an array, or cuTexRefSetAddress2D() to bind the texture reference to linear memory. Function calls to tex_ref_set_format() cannot follow calls to cuTexRefSetAddress2D() for the same texture reference. It is required that dptr be aligned to the appropriate hardware-specific texture alignment. You can query this value using the device attribute CU_DEVICE_ATTRIBUTE_TEXTURE_ALIGNMENT. If an unaligned dptr is supplied, CUDA_ERROR_INVALID_VALUE is returned. pitch has to be aligned to the hardware-specific texture pitch alignment. This value can be queried using the device attribute CU_DEVICE_ATTRIBUTE_TEXTURE_PITCH_ALIGNMENT. If an unaligned pitch is supplied, CUDA_ERROR_INVALID_VALUE is returned. Width and Height, which are specified in elements (or texels), cannot exceed CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_WIDTH and CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_HEIGHT respectively. pitch, which is specified in bytes, cannot exceed CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_PITCH.

Parameters:

h_tex_ref (intptr_t) – Texture reference to bind.
desc (intptr_t) – Descriptor of CUDA array.
dptr (uint64_t) – Device pointer to bind.
pitch (size_t) – Line pitch in bytes.