Functions

CUresult cuKernelGetAttribute ( int* pi, CUfunction_attribute attrib, CUkernel kernel, CUdevice dev )

返回有关内核的信息。

参数

pi

- Returned attribute value

attrib

- Attribute requested

kernel

- Kernel to query attribute of

dev

- Device to query attribute of

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE

描述

在*pi中返回设备dev上内核kernel的属性attrib的整数值。支持的属性包括：

• CU_FUNC_ATTRIBUTE_MAX_THREADS_PER_BLOCK: 每个块的最大线程数，超过此数值将导致内核启动失败。该数值取决于内核和请求的设备。

• CU_FUNC_ATTRIBUTE_SHARED_SIZE_BYTES: 该内核每个块所需的静态分配共享内存大小（以字节为单位）。这不包括用户在运行时请求的动态分配共享内存。

• CU_FUNC_ATTRIBUTE_CONST_SIZE_BYTES: 该内核所需的用户分配常量内存大小（以字节为单位）。

• CU_FUNC_ATTRIBUTE_LOCAL_SIZE_BYTES: 该内核每个线程使用的本地内存大小（以字节为单位）。

• CU_FUNC_ATTRIBUTE_NUM_REGS: 该内核每个线程使用的寄存器数量。

• CU_FUNC_ATTRIBUTE_PTX_VERSION: 内核编译所针对的PTX虚拟架构版本。该值为主要PTX版本号乘以10再加上次要PTX版本号，例如PTX 1.3版本函数将返回值13。请注意，对于CUDA 3.0之前编译的cubin文件，可能返回未定义值0。

• CU_FUNC_ATTRIBUTE_BINARY_VERSION: 内核编译所用的二进制架构版本号。该值的计算方式为主版本号*10 + 次版本号，例如二进制版本1.3的函数将返回值13。注意：对于未正确编码二进制架构版本的旧版cubin文件，此属性将返回值10。

• CU_FUNC_CACHE_MODE_CA: 该属性用于指示内核是否已使用用户指定的编译选项"-Xptxas --dlcm=ca"进行编译。

• CU_FUNC_ATTRIBUTE_MAX_DYNAMIC_SHARED_SIZE_BYTES: 动态分配的共享内存的最大大小（以字节为单位）。

• CU_FUNC_ATTRIBUTE_PREFERRED_SHARED_MEMORY_CARVEOUT: 首选共享内存与L1缓存的分配比例，以共享内存总量的百分比表示。

• CU_FUNC_ATTRIBUTE_CLUSTER_SIZE_MUST_BE_SET: 如果设置了此属性，则内核启动时必须指定有效的集群大小。

• CU_FUNC_ATTRIBUTE_REQUIRED_CLUSTER_WIDTH: 以块为单位的所需集群宽度。

• CU_FUNC_ATTRIBUTE_REQUIRED_CLUSTER_HEIGHT: 以块为单位的必需簇高度。

• CU_FUNC_ATTRIBUTE_REQUIRED_CLUSTER_DEPTH: 以块为单位的所需集群深度。

• CU_FUNC_ATTRIBUTE_NON_PORTABLE_CLUSTER_SIZE_ALLOWED: 表示该函数是否允许以非便携式集群大小启动。1表示允许，0表示禁止。非便携式集群大小可能仅在程序测试过的特定SKU上有效，若在不同硬件平台上运行可能导致启动失败。CUDA API提供了cudaOccupancyMaxActiveClusters来帮助检查当前设备是否支持所需集群大小。便携式集群大小保证在所有高于目标计算能力的硬件上都可用，sm_90架构的便携式集群大小为每集群8个块。未来计算能力版本可能会增加该数值。特定硬件单元可能支持更高的非便携式集群大小。

• CU_FUNC_ATTRIBUTE_CLUSTER_SCHEDULING_POLICY_PREFERENCE: 函数的块调度策略。值类型为CUclusterSchedulingPolicy。

Note:

如果另一个线程同时尝试使用cuKernelSetAttribute()在同一设备上设置相同属性，根据操作系统调度器选择的内存交错访问和内存一致性，属性查询将返回旧值或新值。

另请参阅：

cuLibraryLoadData, cuLibraryLoadFromFile, cuLibraryUnload, cuKernelSetAttribute, cuLibraryGetKernel, cuLaunchKernel, cuKernelGetFunction, cuLibraryGetModule, cuModuleGetFunction, cuFuncGetAttribute

CUresult cuKernelGetFunction ( CUfunction* pFunc, CUkernel kernel )

返回一个函数句柄。

参数

pFunc

- Returned function handle

kernel

- Kernel to retrieve function for the requested context

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_FOUND, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_CONTEXT_IS_DESTROYED

描述

在pFunc中返回当前上下文中请求的内核kernel对应的函数句柄。如果未找到函数句柄，该调用将返回CUDA_ERROR_NOT_FOUND。

另请参阅：

cuLibraryLoadData, cuLibraryLoadFromFile, cuLibraryUnload, cuLibraryGetKernel, cuLibraryGetModule, cuModuleGetFunction

CUresult cuKernelGetLibrary ( CUlibrary* pLib, CUkernel kernel )

返回一个库句柄。

参数

pLib

- Returned library handle

kernel

- Kernel to retrieve library handle

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_FOUND

描述

在pLib中返回请求的内核kernel对应的库句柄

另请参阅：

cuLibraryLoadData, cuLibraryLoadFromFile, cuLibraryUnload, cuLibraryGetKernel

CUresult cuKernelGetName ( const char** name, CUkernel hfunc )

返回CUDA内核句柄对应的函数名称。

参数

name

- The returned name of the function

hfunc

- The function handle to retrieve the name for

返回

CUDA_SUCCESS, CUDA_ERROR_INVALID_VALUE

描述

返回与内核句柄hfunc关联的函数名称到**name中。函数名称以空终止字符串形式返回。返回的名称仅在内核句柄有效时有效。 如果库被卸载或重新加载，必须再次调用API以获取更新后的名称。如果函数未声明为具有C链接，此API可能会返回一个混淆的名称。如果**name或hfunc为NULL，则返回CUDA_ERROR_INVALID_VALUE。

Note:

请注意，此函数也可能返回之前异步启动的错误代码。

CUresult cuKernelGetParamInfo ( CUkernel kernel, size_t paramIndex, size_t* paramOffset, size_t* paramSize )

返回设备端参数布局中内核参数的偏移量和大小。

参数

kernel

- The kernel to query

paramIndex

- The parameter index to query

paramOffset

- Returns the offset into the device-side parameter layout at which the parameter resides

paramSize

- Optionally returns the size of the parameter in the device-side parameter layout

返回

CUDA_SUCCESS, CUDA_ERROR_INVALID_VALUE,

描述

查询kernel参数列表中位于paramIndex处的内核参数，并分别在paramOffset和paramSize中返回该参数在设备端参数布局中的偏移量和大小。此信息可用于通过cudaGraphKernelNodeSetParam()和cudaGraphKernelNodeUpdatesApply()从设备端更新内核节点参数。paramIndex必须小于kernel所接受的参数数量。如果仅需要参数偏移量，可以将paramSize设置为NULL。

Note:

请注意，此函数也可能返回之前异步启动的错误代码。

另请参阅：

cuFuncGetParamInfo

CUresult cuKernelSetAttribute ( CUfunction_attribute attrib, int  val, CUkernel kernel, CUdevice dev )

设置有关内核的信息。

参数

attrib

- Attribute requested

val

- Value to set

kernel

- Kernel to set attribute of

dev

- Device to set attribute of

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE, CUDA_ERROR_OUT_OF_MEMORY

描述

此调用将指定设备dev上内核kernel的属性attrib设置为由val指定的整数值。如果成功设置属性新值，该函数将返回CUDA_SUCCESS。若设置失败，此调用将返回错误。并非所有属性都可设置值。尝试为只读属性设置值将导致错误(CUDA_ERROR_INVALID_VALUE)。

请注意，使用cuFuncSetAttribute()设置的属性将覆盖此API设置的属性，无论调用cuFuncSetAttribute()是在此API调用之前还是之后。但是，cuKernelGetAttribute()将始终返回由此API设置的属性值。

支持的属性包括：

• CU_FUNC_ATTRIBUTE_MAX_DYNAMIC_SHARED_SIZE_BYTES: 这是动态分配的共享内存的最大字节数。该值应包含请求的动态分配共享内存的最大大小。此值与函数属性CU_FUNC_ATTRIBUTE_SHARED_SIZE_BYTES的总和不得超过设备属性CU_DEVICE_ATTRIBUTE_MAX_SHARED_MEMORY_PER_BLOCK_OPTIN。可请求的动态共享内存的最大大小可能因GPU架构而异。

• CU_FUNC_ATTRIBUTE_PREFERRED_SHARED_MEMORY_CARVEOUT: 在L1缓存和共享内存使用相同硬件资源的设备上，此属性设置共享内存的预留偏好比例（占总共享内存的百分比）。参见CU_DEVICE_ATTRIBUTE_MAX_SHARED_MEMORY_PER_MULTIPROCESSOR。这仅是一个提示，驱动程序可根据函数执行需要选择不同的比例。

• CU_FUNC_ATTRIBUTE_REQUIRED_CLUSTER_WIDTH: 所需的块级集群宽度。宽度、高度和深度值必须全为0或全为正数。集群维度的有效性会在启动时进行检查。如果在编译时设置了该值，则不能在运行时设置。在运行时设置该值将返回CUDA_ERROR_NOT_PERMITTED。

• CU_FUNC_ATTRIBUTE_REQUIRED_CLUSTER_HEIGHT: 以块为单位的必需集群高度。宽度、高度和深度值必须全部为0或全部为正数。集群维度的有效性将在启动时检查。如果在编译时设置该值，则无法在运行时设置。在运行时设置将返回CUDA_ERROR_NOT_PERMITTED。

• CU_FUNC_ATTRIBUTE_REQUIRED_CLUSTER_DEPTH: 所需的块集群深度。宽度、高度和深度值必须全部为0或全部为正数。集群维度的有效性将在启动时检查。如果在编译时设置该值，则不能在运行时设置。在运行时设置将返回CUDA_ERROR_NOT_PERMITTED。

• CU_FUNC_ATTRIBUTE_NON_PORTABLE_CLUSTER_SIZE_ALLOWED: 表示该函数是否可以使用非便携式集群大小启动。1表示允许，0表示禁止。

• CU_FUNC_ATTRIBUTE_CLUSTER_SCHEDULING_POLICY_PREFERENCE: 函数的块调度策略。值类型为CUclusterSchedulingPolicy。

Note:

与旧版API cuFuncSetAttribute()相比，该API由于涉及设备级语义，具有更严格的锁定要求。如果多个线程同时尝试在同一设备上设置相同属性，则属性设置结果将取决于操作系统调度器选择的时间交错顺序和内存一致性。

另请参阅：

cuLibraryLoadData, cuLibraryLoadFromFile, cuLibraryUnload, cuKernelGetAttribute, cuLibraryGetKernel, cuLaunchKernel, cuKernelGetFunction, cuLibraryGetModule, cuModuleGetFunction, cuFuncSetAttribute

CUresult cuKernelSetCacheConfig ( CUkernel kernel, CUfunc_cache config, CUdevice dev )

为设备内核设置首选的缓存配置。

参数

kernel

- Kernel to configure cache for

config

- Requested cache configuration

dev

- Device to set attribute of

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE, CUDA_ERROR_OUT_OF_MEMORY

描述

在使用相同硬件资源的L1缓存和共享内存的设备上，这通过config为请求的设备dev上的设备内核kernel设置首选的缓存配置。这只是一个偏好设置。驱动程序会尽可能使用请求的配置，但必要时可以自由选择不同的配置来执行kernel。通过cuCtxSetCacheConfig()设置的任何上下文范围内的首选项将被此每个内核的设置覆盖。

请注意，使用cuFuncSetCacheConfig()设置的属性将覆盖此API设置的属性，无论调用cuFuncSetCacheConfig()是在此API调用之前还是之后进行的。

在L1缓存和共享内存大小固定的设备上，此设置不起作用。

使用与最近偏好设置不同的偏好启动内核可能会插入一个设备端同步点。

支持的缓存配置包括：

• CU_FUNC_CACHE_PREFER_NONE: 对共享内存或L1缓存无偏好（默认设置）

• CU_FUNC_CACHE_PREFER_SHARED: 优先分配更大的共享内存和更小的L1缓存

• CU_FUNC_CACHE_PREFER_L1: 优先使用更大的L1缓存和更小的共享内存

• CU_FUNC_CACHE_PREFER_EQUAL: 倾向于使用大小相等的L1缓存和共享内存

Note:

与旧版API cuFuncSetCacheConfig()相比，该API由于涉及设备级语义，具有更严格的锁定要求。如果多个线程同时尝试在同一设备上设置配置，缓存配置的设置将取决于操作系统调度器选择的交错执行顺序和内存一致性。

另请参阅：

cuLibraryLoadData, cuLibraryLoadFromFile, cuLibraryUnload, cuLibraryGetKernel, cuKernelGetFunction, cuLibraryGetModule, cuModuleGetFunction, cuFuncSetCacheConfig, cuCtxSetCacheConfig, cuLaunchKernel

CUresult cuLibraryEnumerateKernels ( CUkernel* kernels, unsigned int  numKernels, CUlibrary lib )

检索库中的内核句柄。

参数

kernels

- Buffer where the kernel handles are returned to

numKernels

- Maximum number of kernel handles may be returned to the buffer

lib

- Library to query from

返回

CUDA_SUCCESS, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_INVALID_VALUE

描述

在kernels中返回库lib内最多numKernels个内核句柄。当库被卸载时，返回的内核句柄将失效。

另请参阅：

cuLibraryGetKernelCount

CUresult cuLibraryGetGlobal ( CUdeviceptr* dptr, size_t* bytes, CUlibrary library, const char* name )

返回一个全局设备指针。

参数

dptr

- Returned global device pointer for the requested context

bytes

- Returned global size in bytes

library

- Library to retrieve global from

name

- Name of global to retrieve

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_FOUND, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_CONTEXT_IS_DESTROYED

描述

在*dptr和*bytes中返回指定库library和当前上下文中名为name的全局变量的基指针和大小。如果请求的名称name不存在对应的全局变量，该调用将返回CUDA_ERROR_NOT_FOUND。参数dptr或bytes（不能同时为NULL）可以为NULL，此时该参数将被忽略。

另请参阅：

cuLibraryLoadData, cuLibraryLoadFromFile, cuLibraryUnload, cuLibraryGetModule, cuModuleGetGlobal

CUresult cuLibraryGetKernel ( CUkernel* pKernel, CUlibrary library, const char* name )

返回一个内核句柄。

参数

pKernel

- Returned kernel handle

library

- Library to retrieve kernel from

name

- Name of kernel to retrieve

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_FOUND

描述

在pKernel中返回位于库library中名为name的内核句柄。如果未找到内核句柄，该调用将返回CUDA_ERROR_NOT_FOUND。

另请参阅：

cuLibraryLoadData, cuLibraryLoadFromFile, cuLibraryUnload, cuKernelGetFunction, cuLibraryGetModule, cuModuleGetFunction

CUresult cuLibraryGetKernelCount ( unsigned int* count, CUlibrary lib )

返回库中的内核数量。

参数

count

- Number of kernels found within the library

lib

- Library to query

返回

CUDA_SUCCESS, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_INVALID_VALUE

描述

返回lib中内核的数量到count参数。

CUresult cuLibraryGetManaged ( CUdeviceptr* dptr, size_t* bytes, CUlibrary library, const char* name )

返回指向托管内存的指针。

参数

dptr

- Returned pointer to the managed memory

bytes

- Returned memory size in bytes

library

- Library to retrieve managed memory from

name

- Name of managed memory to retrieve

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_FOUND

描述

在*dptr和*bytes中返回请求库library中名为name的托管内存的基指针和大小。如果不存在具有请求名称name的托管内存，则调用返回CUDA_ERROR_NOT_FOUND。参数dptr或bytes（不能同时为NULL）可以为NULL，此时该参数将被忽略。请注意，库library的托管内存跨设备共享，并在库加载到至少一个上下文时注册。

另请参阅：

cuLibraryLoadData, cuLibraryLoadFromFile, cuLibraryUnload

CUresult cuLibraryGetModule ( CUmodule* pMod, CUlibrary library )

返回一个模块句柄。

参数

pMod

- Returned module handle

library

- Library to retrieve module from

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_FOUND, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_CONTEXT_IS_DESTROYED

描述

在pMod中返回与当前上下文关联的模块句柄，该模块位于库library中。如果未找到模块句柄，则调用返回CUDA_ERROR_NOT_FOUND。

另请参阅：

cuLibraryLoadData, cuLibraryLoadFromFile, cuLibraryUnload, cuModuleGetFunction

CUresult cuLibraryGetUnifiedFunction ( void** fptr, CUlibrary library, const char* symbol )

返回指向统一函数的指针。

参数

fptr

- Returned pointer to a unified function

library

- Library to retrieve function pointer memory from

symbol

- Name of function pointer to retrieve

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_FOUND

描述

在*fptr中返回指向由symbol表示的统一函数的函数指针。如果不存在名为symbol的统一函数，该调用将返回CUDA_ERROR_NOT_FOUND。如果系统中不存在具有CU_DEVICE_ATTRIBUTE_UNIFIED_FUNCTION_POINTERS属性的设备，该调用可能会返回CUDA_ERROR_NOT_FOUND。

另请参阅：

cuLibraryLoadData, cuLibraryLoadFromFile, cuLibraryUnload

CUresult cuLibraryLoadData ( CUlibrary* library, const void* code, CUjit_option* jitOptions, void** jitOptionsValues, unsigned int  numJitOptions, CUlibraryOption* libraryOptions, void** libraryOptionValues, unsigned int  numLibraryOptions )

加载一个带有指定代码和选项的库。

参数

library

- Returned library

code

- Code to load

jitOptions

- Options for JIT

jitOptionsValues

- Option values for JIT

numJitOptions

- Number of options

libraryOptions

- Options for loading

libraryOptionValues

- Option values for loading

numLibraryOptions

- Number of options for loading

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_PTX, CUDA_ERROR_UNSUPPORTED_PTX_VERSION, CUDA_ERROR_OUT_OF_MEMORY, CUDA_ERROR_NO_BINARY_FOR_GPU, CUDA_ERROR_SHARED_OBJECT_SYMBOL_NOT_FOUND, CUDA_ERROR_SHARED_OBJECT_INIT_FAILED, CUDA_ERROR_JIT_COMPILER_NOT_FOUND, CUDA_ERROR_NOT_SUPPORTED

描述

获取一个指针code并根据应用程序定义的库加载模式加载对应的库library：

• 如果通过"模块加载"中描述的环境变量将模块加载设置为EAGER模式，library会在调用时立即加载到所有上下文中，并在创建新上下文时自动加载，直到使用cuLibraryUnload()卸载该库为止。

• 如果环境变量设置为LAZY，library不会立即加载到所有现有上下文中，只有当该上下文需要某个函数（例如内核启动）时才会加载。

这些环境变量在CUDA编程指南的"CUDA环境变量"章节中有详细说明。

code可能是由nvcc输出的cubin或fatbin文件，也可能是以NULL结尾的PTX代码（可以是nvcc输出或手动编写）。在进行单独编译时，fatbin文件还应包含可重定位代码。

选项通过jitOptions以数组形式传递，任何对应的参数则在jitOptionsValues中传递。总JIT选项数量通过numJitOptions提供。所有输出将通过jitOptionsValues返回。

库加载选项通过libraryOptions以数组形式传递，任何对应的参数则在libraryOptionValues中传递。总库加载选项的数量通过numLibraryOptions提供。

Note:

如果库包含托管变量且系统中没有设备支持托管变量，此调用预计将返回CUDA_ERROR_NOT_SUPPORTED

另请参阅：

cuLibraryLoadFromFile, cuLibraryUnload, cuModuleLoad, cuModuleLoadData, cuModuleLoadDataEx

CUresult cuLibraryLoadFromFile ( CUlibrary* library, const char* fileName, CUjit_option* jitOptions, void** jitOptionsValues, unsigned int  numJitOptions, CUlibraryOption* libraryOptions, void** libraryOptionValues, unsigned int  numLibraryOptions )

加载具有指定文件和选项的库。

参数

library

- Returned library

fileName

- File to load from

jitOptions

- Options for JIT

jitOptionsValues

- Option values for JIT

numJitOptions

- Number of options

libraryOptions

- Options for loading

libraryOptionValues

- Option values for loading

numLibraryOptions

- Number of options for loading

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_PTX, CUDA_ERROR_UNSUPPORTED_PTX_VERSION, CUDA_ERROR_OUT_OF_MEMORY, CUDA_ERROR_NO_BINARY_FOR_GPU, CUDA_ERROR_SHARED_OBJECT_SYMBOL_NOT_FOUND, CUDA_ERROR_SHARED_OBJECT_INIT_FAILED, CUDA_ERROR_JIT_COMPILER_NOT_FOUND, CUDA_ERROR_NOT_SUPPORTED

描述

获取一个指针code并根据应用程序定义的库加载模式加载对应的库library：

• 如果通过"模块加载"中描述的环境变量将模块加载设置为EAGER模式，library会在调用时立即加载到所有上下文中，并在后续创建新上下文时自动加载，直到使用cuLibraryUnload()卸载该库为止。

• 如果环境变量设置为LAZY，library不会立即加载到所有现有上下文中，只有当该上下文需要某个函数（例如内核启动）时才会加载。

这些环境变量在CUDA编程指南的"CUDA环境变量"章节中有详细说明。

该文件应为nvcc输出的cubin文件，或由nvcc生成/手动编写的PTX文件，亦或是nvcc输出的fatbin文件。在进行单独编译时，fatbin文件还应包含可重定位代码。

选项通过jitOptions以数组形式传递，对应的参数通过jitOptionsValues传递。总选项数由numJitOptions提供。所有输出将通过jitOptionsValues返回。

库加载选项通过libraryOptions以数组形式传递，任何对应的参数则在libraryOptionValues中传递。总库加载选项的数量通过numLibraryOptions提供。

Note:

如果库中包含托管变量而系统中没有设备支持托管变量，此调用预期将返回CUDA_ERROR_NOT_SUPPORTED

另请参阅：

cuLibraryLoadData, cuLibraryUnload, cuModuleLoad, cuModuleLoadData, cuModuleLoadDataEx

CUresult cuLibraryUnload ( CUlibrary library )

卸载一个库。

参数

library

- Library to unload

返回

CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_VALUE

描述

卸载由library指定的库

另请参阅：

cuLibraryLoadData, cuLibraryLoadFromFile, cuModuleUnload