6.26. 纹理引用管理 [已弃用]

本节介绍低级别 CUDA 驱动程序应用程序编程接口中已弃用的纹理引用管理函数。

函数

CUresult cuTexRefCreate ( CUtexref* pTexRef )
创建纹理引用。
CUresult cuTexRefDestroy ( CUtexref hTexRef )
销毁纹理引用。
CUresult cuTexRefGetAddress ( CUdeviceptr* pdptr, CUtexref hTexRef )
获取与纹理引用关联的地址。
CUresult cuTexRefGetAddressMode ( CUaddress_mode* pam, CUtexref hTexRef, int  dim )
获取纹理引用使用的寻址模式。
CUresult cuTexRefGetArray ( CUarray* phArray, CUtexref hTexRef )
获取绑定到纹理引用的数组。
CUresult cuTexRefGetBorderColor ( float* pBorderColor, CUtexref hTexRef )
获取纹理引用使用的边框颜色。
CUresult cuTexRefGetFilterMode ( CUfilter_mode* pfm, CUtexref hTexRef )
获取纹理引用使用的过滤模式。
CUresult cuTexRefGetFlags ( unsigned int* pFlags, CUtexref hTexRef )
获取纹理引用使用的标志。
CUresult cuTexRefGetFormat ( CUarray_format* pFormat, int* pNumChannels, CUtexref hTexRef )
获取纹理引用使用的格式。
CUresult cuTexRefGetMaxAnisotropy ( int* pmaxAniso, CUtexref hTexRef )
获取纹理引用的最大各向异性。
CUresult cuTexRefGetMipmapFilterMode ( CUfilter_mode* pfm, CUtexref hTexRef )
获取纹理引用的 mipmap 过滤模式。
CUresult cuTexRefGetMipmapLevelBias ( float* pbias, CUtexref hTexRef )
获取纹理引用的 mipmap 级别偏差。
CUresult cuTexRefGetMipmapLevelClamp ( float* pminMipmapLevelClamp, float* pmaxMipmapLevelClamp, CUtexref hTexRef )
获取纹理引用的最小/最大 mipmap 级别钳位。
CUresult cuTexRefGetMipmappedArray ( CUmipmappedArray* phMipmappedArray, CUtexref hTexRef )
获取绑定到纹理引用的 mipmapped 数组。
CUresult cuTexRefSetAddress ( size_t* ByteOffset, CUtexref hTexRef, CUdeviceptr dptr, size_t bytes )
将地址绑定为纹理引用。
CUresult cuTexRefSetAddress2D ( CUtexref hTexRef, const CUDA_ARRAY_DESCRIPTOR* desc, CUdeviceptr dptr, size_t Pitch )
将地址绑定为 2D 纹理引用。
CUresult cuTexRefSetAddressMode ( CUtexref hTexRef, int  dim, CUaddress_mode am )
设置纹理引用的寻址模式。
CUresult cuTexRefSetArray ( CUtexref hTexRef, CUarray hArray, unsigned int  Flags )
将数组绑定为纹理引用。
CUresult cuTexRefSetBorderColor ( CUtexref hTexRef, float* pBorderColor )
设置纹理引用的边框颜色。
CUresult cuTexRefSetFilterMode ( CUtexref hTexRef, CUfilter_mode fm )
设置纹理引用的过滤模式。
CUresult cuTexRefSetFlags ( CUtexref hTexRef, unsigned int  Flags )
设置纹理引用的标志。
CUresult cuTexRefSetFormat ( CUtexref hTexRef, CUarray_format fmt, int  NumPackedComponents )
设置纹理引用的格式。
CUresult cuTexRefSetMaxAnisotropy ( CUtexref hTexRef, unsigned int  maxAniso )
设置纹理引用的最大各向异性。
CUresult cuTexRefSetMipmapFilterMode ( CUtexref hTexRef, CUfilter_mode fm )
设置纹理引用的 mipmap 过滤模式。
CUresult cuTexRefSetMipmapLevelBias ( CUtexref hTexRef, float  bias )
设置纹理引用的 mipmap 级别偏差。
CUresult cuTexRefSetMipmapLevelClamp ( CUtexref hTexRef, float  minMipmapLevelClamp, float  maxMipmapLevelClamp )
设置纹理引用的最小/最大 mipmap 级别钳位。
CUresult cuTexRefSetMipmappedArray ( CUtexref hTexRef, CUmipmappedArray hMipmappedArray, unsigned int  Flags )
将 mipmapped 数组绑定到纹理引用。

函数

CUresult cuTexRefCreate ( CUtexref* pTexRef )
创建纹理引用。
参数
pTexRef
- 返回的纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
创建一个纹理引用并在以下位置返回其句柄：*pTexRef。创建后，应用程序必须调用 cuTexRefSetArray() 或 cuTexRefSetAddress() 将引用与已分配的内存关联。其他纹理引用函数用于指定通过此纹理引用读取内存时要使用的格式和解释（寻址、过滤等）。

另请参阅

cuTexRefDestroy

CUresult cuTexRefDestroy ( CUtexref hTexRef )
销毁纹理引用。
参数
hTexRef
- 要销毁的纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
销毁由以下项指定的纹理引用：hTexRef.

另请参阅

cuTexRefCreate

CUresult cuTexRefGetAddress ( CUdeviceptr* pdptr, CUtexref hTexRef )
获取与纹理引用关联的地址。
参数
pdptr
- 返回的设备地址
hTexRef
- 纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
在以下位置返回：*pdptr绑定到纹理引用的基地址hTexRef，如果纹理引用未绑定到任何设备内存范围，则返回 CUDA_ERROR_INVALID_VALUE。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetAddressMode ( CUaddress_mode* pam, CUtexref hTexRef, int  dim )
获取纹理引用使用的寻址模式。
参数
pam
- 返回的寻址模式
hTexRef
- 纹理引用
dim
- 维度
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
在以下位置返回：*pam对应于维度的寻址模式dim纹理引用的hTexRef。目前，唯一有效的维度值是dim0 和 1。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetArray ( CUarray* phArray, CUtexref hTexRef )
获取绑定到纹理引用的数组。
参数
phArray
- 返回的数组
hTexRef
- 纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
在以下位置返回：*phArray绑定到纹理引用的 CUDA 数组hTexRef，如果纹理引用未绑定到任何 CUDA 数组，则返回 CUDA_ERROR_INVALID_VALUE。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetBorderColor ( float* pBorderColor, CUtexref hTexRef )
获取纹理引用使用的边框颜色。
参数
pBorderColor
- 返回的 RGBA 颜色类型和值
hTexRef
- 纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
在以下位置返回：pBorderColor，纹理引用使用的 RGBA 颜色值hTexRef。颜色值为浮点类型，并按以下顺序保存颜色分量：pBorderColor[0] 保存 'R' 分量 pBorderColor[1] 保存 'G' 分量 pBorderColor[2] 保存 'B' 分量 pBorderColor[3] 保存 'A' 分量

另请参阅

cuTexRefSetAddressMode, cuTexRefSetAddressMode, cuTexRefSetBorderColor

CUresult cuTexRefGetFilterMode ( CUfilter_mode* pfm, CUtexref hTexRef )
获取纹理引用使用的过滤模式。
参数
pfm
- 返回的过滤模式
hTexRef
- 纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
在以下位置返回：*pfm纹理引用的过滤模式hTexRef.

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetFlags ( unsigned int* pFlags, CUtexref hTexRef )
获取纹理引用使用的标志。
参数
pFlags
- 返回的标志
hTexRef
- 纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
在以下位置返回：*pFlags纹理引用的标志hTexRef.

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFormat

CUresult cuTexRefGetFormat ( CUarray_format* pFormat, int* pNumChannels, CUtexref hTexRef )
获取纹理引用使用的格式。
参数
pFormat
- 返回的格式
pNumChannels
- 返回的组件数量
hTexRef
- 纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
在以下位置返回：*pFormat和*pNumChannels绑定到纹理引用的 CUDA 数组的格式和组件数量hTexRef。如果pFormat或pNumChannels为 NULL，则会被忽略。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags

CUresult cuTexRefGetMaxAnisotropy ( int* pmaxAniso, CUtexref hTexRef )
获取纹理引用的最大各向异性。
参数
pmaxAniso
- 返回的最大各向异性
hTexRef
- 纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
返回pmaxAniso中用于通过纹理引用读取内存的最大各向异性hTexRef.

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetMipmapFilterMode ( CUfilter_mode* pfm, CUtexref hTexRef )
获取纹理引用的 mipmap 过滤模式。
参数
pfm
- 返回的 mipmap 过滤模式
hTexRef
- 纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
返回pfm中用于通过纹理引用读取内存的最大各向异性hTexRef.

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetMipmapLevelBias ( float* pbias, CUtexref hTexRef )
获取纹理引用的 mipmap 级别偏差。
参数
pbias
- 返回的 mipmap 级别偏差
hTexRef
- 纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
返回pBias中添加到指定 mipmap 级别的偏差，用于通过纹理引用读取内存hTexRef.

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetMipmapLevelClamp ( float* pminMipmapLevelClamp, float* pmaxMipmapLevelClamp, CUtexref hTexRef )
获取纹理引用的最小/最大 mipmap 级别钳位值。
参数
pminMipmapLevelClamp
- 返回的 mipmap 最小级别钳位值
pmaxMipmapLevelClamp
- 返回的 mipmap 最大级别钳位值
hTexRef
- 纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
返回pminMipmapLevelClamp和pmaxMipmapLevelClamp中用于通过纹理引用读取内存的最大各向异性hTexRef.

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefGetMipmappedArray ( CUmipmappedArray* phMipmappedArray, CUtexref hTexRef )
获取绑定到纹理引用的 mipmapped 数组。
参数
phMipmappedArray
- 返回的 mipmapped 数组
hTexRef
- 纹理引用
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
在以下位置返回：*phMipmappedArray绑定到纹理引用的 CUDA mipmapped 数组hTexRef，或者如果纹理引用未绑定到任何 CUDA mipmapped 数组，则返回 CUDA_ERROR_INVALID_VALUE。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetAddress ( size_t* ByteOffset, CUtexref hTexRef, CUdeviceptr dptr, size_t bytes )
将地址绑定为纹理引用。
参数
ByteOffset
- 返回的字节偏移量
hTexRef
- 要绑定的纹理引用
dptr
- 要绑定的设备指针
bytes
- 要绑定的内存大小（以字节为单位）
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
将线性地址范围绑定到纹理引用hTexRef。任何先前与纹理引用关联的地址或 CUDA 数组状态都会被此函数取代。先前绑定到hTexRef的任何内存都将被解除绑定。

由于硬件对纹理基地址强制执行对齐要求，cuTexRefSetAddress() 在*ByteOffset中传回一个字节偏移量，该偏移量必须应用于纹理获取，以便从所需的内存中读取数据。此偏移量必须除以纹素大小，并传递给从纹理读取的内核，以便可以将它们应用于 tex1Dfetch() 函数。

如果设备内存指针是从 cuMemAlloc() 返回的，则偏移量保证为 0，并且可以将 NULL 作为ByteOffset参数传递。

线性地址范围中的元素（或纹素）总数不能超过 CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE1D_LINEAR_WIDTH。元素数量的计算方式为 (bytes/ bytesPerElement)，其中 bytesPerElement 由使用 cuTexRefSetFormat() 设置的数据格式和组件数量确定。

另请参阅

cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetAddress2D ( CUtexref hTexRef, const CUDA_ARRAY_DESCRIPTOR* desc, CUdeviceptr dptr, size_t Pitch )
将地址绑定为 2D 纹理引用。
参数
hTexRef
- 要绑定的纹理引用
desc
- CUDA 数组的描述符
dptr
- 要绑定的设备指针
Pitch
- 行距（以字节为单位）
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
将线性地址范围绑定到纹理引用hTexRef。任何先前与纹理引用关联的地址或 CUDA 数组状态都会被此函数取代。先前绑定到hTexRef的任何内存都将被解除绑定。

在内核内部使用 tex2D() 函数需要调用 cuTexRefSetArray() 将相应的纹理引用绑定到数组，或者调用 cuTexRefSetAddress2D() 将纹理引用绑定到线性内存。

对于同一纹理引用，在调用 cuTexRefSetAddress2D() 之后，不能再调用 cuTexRefSetFormat() 函数。

要求dptr与适当的硬件特定纹理对齐方式对齐。您可以使用设备属性 CU_DEVICE_ATTRIBUTE_TEXTURE_ALIGNMENT 查询此值。如果提供未对齐的dptr，则返回 CUDA_ERROR_INVALID_VALUE。

Pitch必须与硬件特定的纹理行距对齐方式对齐。可以使用设备属性 CU_DEVICE_ATTRIBUTE_TEXTURE_PITCH_ALIGNMENT 查询此值。如果未对齐的Pitch，则返回 CUDA_ERROR_INVALID_VALUE。

以元素（或纹素）指定的 Width 和 Height，不能分别超过 CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_WIDTH 和 CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_HEIGHT。Pitch，以字节指定，不能超过 CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_PITCH。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetAddressMode ( CUtexref hTexRef, int  dim, CUaddress_mode am )
设置纹理引用的寻址模式。
参数
hTexRef
- 纹理引用
dim
- 维度
am
- 要设置的寻址模式
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
指定给定维度am的寻址模式dim纹理引用的hTexRef。如果dim为零，寻址模式应用于用于从纹理获取数据的函数的第一个参数；如果dim为 1，则应用于第二个参数，依此类推。CUaddress_mode 定义为
‎   typedef enum CUaddress_mode_enum {
            CU_TR_ADDRESS_MODE_WRAP = 0,
            CU_TR_ADDRESS_MODE_CLAMP = 1,
            CU_TR_ADDRESS_MODE_MIRROR = 2,
            CU_TR_ADDRESS_MODE_BORDER = 3
         } CUaddress_mode;

请注意，如果hTexRef绑定到线性内存，则此调用无效。此外，如果未设置标志 CU_TRSF_NORMALIZED_COORDINATES，则唯一支持的地址模式是 CU_TR_ADDRESS_MODE_CLAMP。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetArray ( CUtexref hTexRef, CUarray hArray, unsigned int  Flags )
将数组绑定为纹理引用。
参数
hTexRef
- 要绑定的纹理引用
hArray
- 要绑定的数组
Flags
- 选项（必须为 CU_TRSA_OVERRIDE_FORMAT）
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
将 CUDA 数组hArray绑定到纹理引用hTexRef。任何先前与纹理引用关联的地址或 CUDA 数组状态都会被此函数取代。Flags必须设置为 CU_TRSA_OVERRIDE_FORMAT。先前绑定到hTexRef的任何内存都将被解除绑定。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetBorderColor ( CUtexref hTexRef, float* pBorderColor )
设置纹理引用的边框颜色。
参数
hTexRef
- 纹理引用
pBorderColor
- RGBA 颜色
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
通过pBorderColor绑定到纹理引用hTexRef指定 RGBA 颜色的值。颜色值仅支持 float 类型，并按以下顺序保存颜色分量：pBorderColor[0] 保存 'R' 分量 pBorderColor[1] 保存 'G' 分量 pBorderColor[2] 保存 'B' 分量 pBorderColor[3] 保存 'A' 分量

请注意，只有当使用 cuTexRefSetAddressMode 将地址模式设置为 CU_TR_ADDRESS_MODE_BORDER 时，才能设置颜色值。使用整数边框颜色值的应用程序必须将其值“reinterpret_cast”为 float。

另请参阅

cuTexRefSetAddressMode, cuTexRefGetAddressMode, cuTexRefGetBorderColor

CUresult cuTexRefSetFilterMode ( CUtexref hTexRef, CUfilter_mode fm )
设置纹理引用的过滤模式。
参数
hTexRef
- 纹理引用
fm
- 要设置的过滤模式
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
指定fm在通过纹理引用读取内存时要使用的过滤模式hTexRef。CUfilter_mode_enum 定义为

‎   typedef enum CUfilter_mode_enum {
            CU_TR_FILTER_MODE_POINT = 0,
            CU_TR_FILTER_MODE_LINEAR = 1
         } CUfilter_mode;

请注意，如果hTexRef绑定到线性内存。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetFlags ( CUtexref hTexRef, unsigned int  Flags )
设置纹理引用的标志。
参数
hTexRef
- 纹理引用
Flags
- 设置可选标志
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
通过以下方式指定可选标志Flags以指定通过纹理引用返回的数据的行为hTexRef。 有效的标志包括

  • CU_TRSF_READ_AS_INTEGER，它禁止纹理将整数数据提升为 [0, 1] 范围内的浮点数据的默认行为。 请注意，无论是否指定此标志，32 位整数格式的纹理都不会被提升；

  • CU_TRSF_NORMALIZED_COORDINATES，它禁止纹理坐标范围从 [0, Dim)（其中 Dim 是 CUDA 数组的宽度或高度）的默认行为。 相反，纹理坐标 [0, 1.0) 引用数组维度的整个宽度；

  • CU_TRSF_DISABLE_TRILINEAR_OPTIMIZATION，它禁用任何三线性过滤优化。 三线性优化通过在可以近似预期结果的情况下允许对纹理进行双线性过滤来提高纹理过滤性能。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetFormat ( CUtexref hTexRef, CUarray_format fmt, int  NumPackedComponents )
设置纹理引用的格式。
参数
hTexRef
- 纹理引用
fmt
- 要设置的格式
NumPackedComponents
- 每个数组元素的组件数
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
指定纹理引用要读取的数据的格式hTexRef. fmt和NumPackedComponents与 CUDA_ARRAY_DESCRIPTOR 结构的 Format 和 NumChannels 成员完全类似：它们指定每个组件的格式和每个数组元素的组件数。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat, cudaCreateChannelDesc

CUresult cuTexRefSetMaxAnisotropy ( CUtexref hTexRef, unsigned int  maxAniso )
设置纹理引用的最大各向异性。
参数
hTexRef
- 纹理引用
maxAniso
- 最大各向异性
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
指定最大各向异性maxAniso在通过纹理引用读取内存时要使用的过滤模式hTexRef.

请注意，如果hTexRef绑定到线性内存。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetMipmapFilterMode ( CUtexref hTexRef, CUfilter_mode fm )
设置纹理引用的mipmap过滤模式。
参数
hTexRef
- 纹理引用
fm
- 要设置的过滤模式
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
指定mipmap过滤模式fm在通过纹理引用读取内存时要使用的过滤模式hTexRef。CUfilter_mode_enum 定义为

‎   typedef enum CUfilter_mode_enum {
            CU_TR_FILTER_MODE_POINT = 0,
            CU_TR_FILTER_MODE_LINEAR = 1
         } CUfilter_mode;

请注意，如果hTexRef未绑定到mipmap数组。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetMipmapLevelBias ( CUtexref hTexRef, float  bias )
设置纹理引用的mipmap级别偏差。
参数
hTexRef
- 纹理引用
bias
- Mipmap级别偏差
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
指定mipmap级别偏差bias在通过纹理引用读取内存时添加到指定的mipmap级别hTexRef.

请注意，如果hTexRef未绑定到mipmap数组。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetMipmapLevelClamp ( CUtexref hTexRef, float  minMipmapLevelClamp, float  maxMipmapLevelClamp )
设置纹理引用的mipmap最小/最大mipmap级别钳位。
参数
hTexRef
- 纹理引用
minMipmapLevelClamp
- Mipmap最小级别钳位
maxMipmapLevelClamp
- Mipmap最大级别钳位
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
指定最小/最大mipmap级别钳位，minMipmapLevelClamp和maxMipmapLevelClamp分别在通过纹理引用读取内存时使用hTexRef.

请注意，如果hTexRef未绑定到mipmap数组。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetArray, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat

CUresult cuTexRefSetMipmappedArray ( CUtexref hTexRef, CUmipmappedArray hMipmappedArray, unsigned int  Flags )
将mipmap数组绑定到纹理引用。
参数
hTexRef
- 要绑定的纹理引用
hMipmappedArray
- 要绑定的mipmap数组
Flags
- 选项（必须为 CU_TRSA_OVERRIDE_FORMAT）
返回值

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

已弃用

描述
绑定 CUDA mipmap数组hMipmappedArray绑定到纹理引用hTexRef。任何先前与纹理引用关联的地址或 CUDA 数组状态都会被此函数取代。Flags必须设置为 CU_TRSA_OVERRIDE_FORMAT。先前绑定到hTexRef的任何内存都将被解除绑定。

另请参阅

cuTexRefSetAddress, cuTexRefSetAddress2D, cuTexRefSetAddressMode, cuTexRefSetFilterMode, cuTexRefSetFlags, cuTexRefSetFormat, cuTexRefGetAddress, cuTexRefGetAddressMode, cuTexRefGetArray, cuTexRefGetFilterMode, cuTexRefGetFlags, cuTexRefGetFormat