CUDA 驱动程序 API :: CUDA 工具包文档

6.29. 表面对象管理

本节介绍低级 CUDA 驱动程序应用程序编程接口的表面对象管理功能。表面对象 API 仅在计算能力为 3.0 或更高的设备上受支持。

函数

CUresult cuSurfObjectCreate ( CUsurfObject* pSurfObject, const CUDA_RESOURCE_DESC* pResDesc ): 创建表面对象。
CUresult cuSurfObjectDestroy ( CUsurfObject surfObject ): 销毁表面对象。
CUresult cuSurfObjectGetResourceDesc ( CUDA_RESOURCE_DESC* pResDesc, CUsurfObject surfObject ): 返回表面对象的资源描述符。

函数

CUresult cuSurfObjectCreate ( CUsurfObject* pSurfObject, const CUDA_RESOURCE_DESC* pResDesc )

创建表面对象。

参数

pSurfObject: - 要创建的表面对象
pResDesc: - 资源描述符

返回值

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 调用访问。

另请参阅

cuSurfObjectDestroy, cudaCreateSurfaceObject

CUresult cuSurfObjectDestroy ( CUsurfObject surfObject )