6.29. 表面对象管理
本节介绍底层CUDA驱动应用程序编程接口中的表面对象管理功能。 表面对象API仅支持计算能力3.0或更高的设备。
Functions
- CUresult cuSurfObjectCreate ( CUsurfObject* pSurfObject, const CUDA_RESOURCE_DESC* pResDesc )
- Creates a surface object.
- CUresult cuSurfObjectDestroy ( CUsurfObject surfObject )
- Destroys a surface object.
- CUresult cuSurfObjectGetResourceDesc ( CUDA_RESOURCE_DESC* pResDesc, CUsurfObject surfObject )
- Returns a surface object's resource descriptor.
Functions
- CUresult cuSurfObjectCreate ( CUsurfObject* pSurfObject, const CUDA_RESOURCE_DESC* pResDesc )
-
创建一个表面对象。
参数
- pSurfObject
- - Surface object to create
- pResDesc
- - Resource descriptor
返回
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
描述
创建一个表面对象并在pSurfObject中返回它。pResDesc描述了要执行表面加载/存储操作的数据。CUDA_RESOURCE_DESC::resType必须为CU_RESOURCE_TYPE_ARRAY，且CUDA_RESOURCE_DESC::res::array::hArray必须设置为有效的CUDA数组句柄。CUDA_RESOURCE_DESC::flags必须设置为零。
表面对象仅支持计算能力3.0或更高的设备。此外，表面对象是一个不透明的值，因此应仅通过CUDA API调用来访问。
另请参阅：
- CUresult cuSurfObjectDestroy ( CUsurfObject surfObject )
-
销毁一个表面对象。
参数
- surfObject
- - Surface object to destroy
- CUresult cuSurfObjectGetResourceDesc ( CUDA_RESOURCE_DESC* pResDesc, CUsurfObject surfObject )
-
返回表面对象的资源描述符。
参数
- pResDesc
- - Resource descriptor
- surfObject
- - Surface object