Appendix F: Error Codes
附录F：错误代码
This section lists OpenCL error codes and their meanings.
本节列出了OpenCL错误代码及其含义。
| Error Code 错误代码 | Brief Description 简略描述 |
|---|---|
| This is a special error code to indicate that the API executed successfully, without errors. 这是一个特殊的错误代码，表示API执行成功，没有错误。 | |
| Returned when clBuildProgram failed to build the specified program. 当clBuildProgram无法生成指定程序时返回。 | |
| missing before version 1.2. | Returned when clCompileProgram failed to compile the specified program. |
| Returned when compiling or building a program from source or IL when CL_DEVICE_COMPILER_AVAILABLE is CL_FALSE. 当CL_DEVICE_COMPILER_AVAILABLE为CL_FALSE时，从源代码或IL编译或构建程序时返回。 | |
| Returned when no devices were found that match the specified device type. 当没有找到与指定设备类型匹配的设备时返回。 | |
| Returned when attempting to use a device when CL_DEVICE_AVAILABLE is CL_FALSE. 当CL_DEVICE_AVAILABLE为CL_FALSE时，尝试使用设备时返回。 | |
| missing before version 1.2. | Returned when device partitioning is supported but the device could not be further partitioned. 当支持设备分区但设备无法进一步分区时返回。 |
| CL_EXEC_STATUS_ERROR_FOR_EVENTS_IN_WAIT_LIST missing before version 1.1. | Returned by blocking APIs when an event in the event wait list has a negative value, indicating it is in an error state. 当事件等待列表中的事件为负值时，通过阻塞API返回，表示它处于错误状态。 |
| Returned when attempting to copy images that do not use the same image format. 尝试复制不使用相同图像格式的图像时返回。 | |
| Returned when attempting to create or use an image format that is not supported. 尝试创建或使用不支持的图像格式时返回。 | |
| Returned when attempting to get or set a kernel argument using an invalid index for the specified kernel. 当尝试使用指定内核的无效索引获取或设置内核参数时返回。 | |
| Returned when the specified size of a kernel argument does not match the size of the kernel argument. 当内核参数的指定大小与内核参数的大小不匹配时返回。 | |
| Returned when attempting to set a kernel argument that is not valid. 尝试设置无效的内核参数时返回。 | |
| Returned when a program binary is not valid for a device. 当程序二进制文件对设备无效时返回。 | |
| Returned when attempting to create a buffer or a sub-buffer with an invalid size. 尝试创建大小无效的缓冲区或子缓冲区时返回。 | |
| Returned when build options passed to clBuildProgram are not valid. 当传递给clBuildProgram的构建选项无效时返回。 | |
| Returned when the specified command-queue is not a valid command-queue. 当指定的命令队列不是有效的命令队列时返回。 | |
| missing before version 1.2. | Returned when compiler options passed to clCompileProgram are not valid. 当传递给clCompileProgram的编译器选项无效时返回。 |
| Returned when a specified context is not a valid context, or when mixing objects from multiple contexts. 当指定的上下文不是有效上下文，或者混合了多个上下文中的对象时返回。 | |
| Returned when a specified device is not a valid device. 当指定的设备不是有效设备时返回。 | |
| CL_INVALID_DEVICE_PARTITION_COUNT missing before version 1.2. | Returned when the requested device partitioning using CL_DEVICE_PARTITION_BY_COUNTS is not valid. 当使用CL_DEVICE_PARTITION_BY_COUNTS请求的设备分区无效时返回。 |
| missing before version 2.0. | Returned when setting a device queue kernel argument to a value that is not a valid device command-queue. 将设备队列内核参数设置为无效的设备命令队列值时返回。 |
| Returned when the requested device type is not a valid value. 当请求的设备类型不是有效值时返回。 | |
| Returned when a specified event object is not a valid event object. 当指定的事件对象不是有效的事件对象时返回。 | |
| Returned when the specified event wait list or number of events in the wait list is not valid. 当指定的事件等待列表或等待列表中的事件数无效时返回。 | |
| Returned when the specified global offset and global work size exceeds the limits of the device. 当指定的全局偏移量和全局工作大小超过设备的限制时返回。 | |
| Returned when the specified global work size exceeds the limits of the device. 当指定的全局工作大小超过设备的限制时返回。 | |
| Returned when the specified host pointer is not valid for the specified flags. 当指定的主机指针对指定的标志无效时返回。 | |
| missing before version 1.2. | Returned when the specified image descriptor is 当指定的图像描述符为NULL或指定无效值时返回。 |
| Returned when the specified image format descriptor is 当指定的图像格式描述符为NULL或指定无效值时返回。 | |
| Returned when the specified image dimensions exceed the maximum dimensions for a device or all devices in a context. 当指定的图像尺寸超过某个设备或上下文中所有设备的最大尺寸时返回。 | |
| Returned when the specified kernel is not a valid kernel object. 当指定的内核不是有效的内核对象时返回。 | |
| Returned when enqueing a kernel when some kernel arguments have not been set or are invalid. 当某些内核参数未设置或无效时查询内核时返回。 | |
| Returned when creating a kernel for multiple devices where the number of kernel arguments or kernel argument types are not the same for all devices. 为多个设备创建内核时返回，其中所有设备的内核参数数量或内核参数类型不相同。 | |
| Returned when creating a kernel when no kernel with the specified name exists in the program object. 当程序对象中不存在具有指定名称的内核时，在创建内核时返回。 | |
| missing before version 1.2. | Returned when build options passed to clLinkProgram are not valid. 当传递给clLinkProgram的构建选项无效时返回。 |
| Returned when a specified memory object is not a valid memory object. 当指定的内存对象不是有效的内存对象时返回。 | |
| This is a generic error code that is returned when the requested operation is not a valid operation. 这是一个通用错误代码，当请求的操作无效时返回。 | |
| missing before version 2.0. | Returned when attempting to create a pipe with an invalid packet size or number of packets. 尝试创建数据包大小或数据包数量无效的管道时返回。 |
| Returned when the specified platform is not a valid platform. 当指定的平台不是有效平台时返回。 | |
| Returned when a specified program is not a valid program object. 当指定的程序不是有效的程序对象时返回。 | |
| Returned when the specified program is valid but has not been successfully built. 当指定的程序有效但尚未成功构建时返回。 | |
| missing before version 1.1. | Returned when a specified property name is invalid, when the value for a property name is invalid, or when the same property name is specified more than once. 当指定的属性名无效、属性名的值无效或多次指定同一属性名时返回。 |
| Returned when specified queue properties are valid but are not supported by the device. 当指定的队列属性有效但设备不支持时返回。 | |
| Returned when a specified sampler is not a valid sampler object. 当指定的采样器不是有效的采样器对象时返回。 | |
| missing before version 2.2. | Returned when the specified specialization constant ID is not valid for the specified program. 当指定的专门化常量ID对指定程序无效时返回。 |
| This is a generic error that is returned when a specified value is not a valid value. 这是一个通用错误，当指定值不是有效值时返回。 | |
| Returned by clEnqueueNDRangeKernel when the specified work dimension is not valid. | |
| Returned by clEnqueueNDRangeKernel when the specified total work-group size is not valid for the specified kernel or device. 当指定的总工作组大小对指定的内核或设备无效时，clEnqueueNDRangeKernel返回。 | |
| Returned by clEnqueueNDRangeKernel when the specified work-group size in one dimension is not valid for the device. 当一维中指定的工作组大小对设备无效时，clEnqueueNDRangeKernel返回。 | |
| CL_KERNEL_ARG_INFO_NOT_AVAILABLE missing before version 1.2. | Returned by clGetKernelArgInfo when kernel argument information is not available for the specified kernel. 当指定内核的内核参数信息不可用时，clGetCernelArgInfo返回。 |
| missing before version 1.2. | Returned by clLinkProgram when there is a failure to link the specified binaries or libraries. 当链接指定的二进制文件或库失败时，clLinkProgram返回。 |
| missing before version 1.2. | Returned by clLinkProgram when CL_DEVICE_LINKER_AVAILABLE is CL_FALSE. 当CL_DEVICE_LINKER_AVAILABLE为CL_FALSE时，clLinkProgram返回。 |
| Returned when there is a failure to map the specified region into the host address space. 当无法将指定区域映射到主机地址空间时返回。 | |
| Returned when copying from one region of a memory object to another where the source and destination regions overlap. 从内存对象的一个区域复制到源区域和目标区域重叠的另一个区域时返回。 | |
| Returned when there is a failure to allocate memory for a memory object. 当为内存对象分配内存失败时返回。 | |
| CL_MISALIGNED_SUB_BUFFER_OFFSET missing before version 1.1. | Returned when a sub-buffer object is created or used that is not aligned to CL_DEVICE_MEM_BASE_ADDR_ALIGN for the device. 当创建或使用的子缓冲区对象未与设备的CL_DEVICE_MEM_BASE_ADDR_ALIGN对齐时返回。 |
| This is a generic error that is returned when memory could not be allocated on the host. 这是一个通用错误，当无法在主机上分配内存时返回。 | |
| This is a generic error that is returned when resources could not be allocated on the device. 这是一个通用错误，当无法在设备上分配资源时返回。 | |
| CL_MAX_SIZE_RESTRICTION_EXCEEDED missing before version 2.2. | Returned when the size of the specified kernel argument value exceeds the maximum size defined for the kernel argument. 当指定的内核参数值的大小超过为内核参数定义的最大大小时返回。 |
| Returned by clGetEventProfilingInfo when the command associated with the specified event was not enqueued into a command-queue with CL_QUEUE_PROFILING_ENABLE. 当与指定事件关联的命令未通过CL_QUEUE_PROFILING_ENABLE排入命令队列时，由clGetEventProfilingInfo返回。 | |
| provided by the | Returned when the specified command-buffer is not a valid command-buffer. 当指定的命令缓冲区不是有效的命令缓冲区时返回。 |
| CL_INVALID_SYNC_POINT_WAIT_LIST_KHR provided by the | Returned when the specified sync point wait list or number of sync points in the wait list is not valid. 当指定的同步点等待列表或等待列表中的同步点数量无效时返回。 |
| CL_INCOMPATIBLE_COMMAND_QUEUE_KHR provided by the | Returned when one or more command-queues is incompatible with a command-buffer. 当一个或多个命令队列与命令缓冲区不兼容时返回。 |
| CL_INVALID_MUTABLE_COMMAND_KHR provided by the | Returned when a specified command is not a valid mutable-command object. 当指定的命令不是有效的可变命令对象时返回。 |
| provided by the | Returned when a Direct3D 10 device cannot interoperate with OpenCL device IDs. 当Direct3D 10设备无法与OpenCL设备ID互操作时返回。 |
| provided by the | Returned when an OpenCL object cannot be created from a Direct3D 10 resource. 当无法从Direct3D 10资源创建OpenCL对象时返回。 |
| CL_D3D10_RESOURCE_ALREADY_ACQUIRED_KHR provided by the | Returned when attempting to acquire an OpenCL object created from a Direct3D 10 resource that was already acquired. 尝试获取从已获取的Direct3D 10资源创建的OpenCL对象时返回。 |
| CL_D3D10_RESOURCE_NOT_ACQUIRED_KHR provided by the | Returned when attempting to release an OpenCL object created from a Direct3D 10 resource that has not been acquired. 尝试释放从尚未获取的Direct3D 10资源创建的OpenCL对象时返回。 |
| provided by the | Returned when a Direct3D 11 device cannot interoperate with OpenCL device IDs. 当Direct3D 11设备无法与OpenCL设备ID互操作时返回。 |
| provided by the | Returned when an OpenCL object cannot be created from a Direct3D 11 resource. 当无法从Direct3D 11资源创建OpenCL对象时返回。 |
| CL_D3D11_RESOURCE_ALREADY_ACQUIRED_KHR provided by the | Returned when attempting to acquire an OpenCL object created from a Direct3D 11 resource that was already acquired. 尝试获取从已获取的Direct3D 11资源创建的OpenCL对象时返回。 |
| CL_D3D11_RESOURCE_NOT_ACQUIRED_KHR provided by the | Returned when attempting to release an OpenCL object created from a Direct3D 11 resource that has not been acquired. 尝试释放从尚未获取的Direct3D 11资源创建的OpenCL对象时返回。 |
| CL_INVALID_DX9_MEDIA_ADAPTER_KHR provided by the | Returned when a DirectX 9 media adapter cannot interoperate with OpenCL device IDs. 当DirectX 9媒体适配器无法与OpenCL设备ID互操作时返回。 |
| CL_INVALID_DX9_MEDIA_SURFACE_KHR provided by the | Returned when an OpenCL object cannot be created from a DirectX 9 media surface. 当无法从DirectX 9媒体表面创建OpenCL对象时返回。 |
| CL_DX9_MEDIA_SURFACE_ALREADY_ACQUIRED_KHR provided by the | Returned when attempting to acquire an OpenCL object created from a DirectX 9 media surface that was already acquired. 尝试获取从已获取的DirectX 9媒体表面创建的OpenCL对象时返回。 |
| CL_DX9_MEDIA_SURFACE_NOT_ACQUIRED_KHR provided by the | Returned when attempting to release an OpenCL object created from a DirectX 9 media surface that has not been acquired. 尝试释放从尚未获取的DirectX 9媒体表面创建的OpenCL对象时返回。 |
| CL_EGL_RESOURCE_NOT_ACQUIRED_KHR provided by the | Possible event status if an EGL resource is used without being acquired. 如果在未获取的情况下使用EGL资源，可能会出现事件状态。 |
| provided by the | Returned when the specified EGL object is not valid. 当指定的EGL对象无效时返回。 |
| Returned when the specified OpenGL object is not valid, or when there is no associated OpenGL object for an OpenCL object. 当指定的OpenGL对象无效或OpenCL对象没有关联的OpenGL对象时返回。 | |
| CL_INVALID_GL_SHAREGROUP_REFERENCE_KHR provided by the | Returned when the specified OpenGL sharing context creation property is not valid. 当指定的OpenGL共享上下文创建属性无效时返回。 |
| provided by the | Returned by clGetPlatformIDs when no platforms are available. 当没有可用平台时，由clGetPlatformIDs返回。 |
| provided by the | Returned when the specified semaphore is not a valid semaphore. 当指定的信号量不是有效的信号量时返回。 |
| provided by the | Returned when the specified context has already been terminated, or as an event status for terminated commands. 当指定的上下文已经终止时返回，或者作为终止命令的事件状态返回。 |
扫一扫
2769
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
