jcuda.driver
Class JCudaDriver

java.lang.Object
  extended by jcuda.driver.JCudaDriver

public class JCudaDriver
extends java.lang.Object

Java bindings for the NVidia CUDA driver API.

Most comments are extracted from the CUDA online documentation


Field Summary
static Pointer CU_LAUNCH_PARAM_BUFFER_POINTER
          Indicator that the next value in the \p extra parameter to ::cuLaunchKernel will be a pointer to a buffer containing all kernel parameters used for launching kernel \p f.
static Pointer CU_LAUNCH_PARAM_BUFFER_SIZE
          Indicator that the next value in the \p extra parameter to ::cuLaunchKernel will be a pointer to a size_t which contains the size of the buffer specified with ::CU_LAUNCH_PARAM_BUFFER_POINTER.
static Pointer CU_LAUNCH_PARAM_END
          End of array terminator for the \p extra parameter to ::cuLaunchKernel
static int CU_MEMHOSTALLOC_DEVICEMAP
          If set, host memory is mapped into CUDA address space and JCudaDriver#cuMemHostGetDevicePointer may be called on the host pointer.
static int CU_MEMHOSTALLOC_PORTABLE
          If set, host memory is portable between CUDA contexts.
static int CU_MEMHOSTALLOC_WRITECOMBINED
          If set, host memory is allocated as write-combined - fast to write, faster to DMA, slow to read except via SSE4 streaming load instruction (MOVNTDQA).
static int CU_MEMHOSTREGISTER_DEVICEMAP
          If set, host memory is mapped into CUDA address space and ::cuMemHostGetDevicePointer() may be called on the host pointer.
static int CU_MEMHOSTREGISTER_PORTABLE
          If set, host memory is portable between CUDA contexts.
static int CU_MEMPEERREGISTER_DEVICEMAP
          Deprecated. This value has been added in CUDA 4.0 RC, and removed in CUDA 4.0 RC2
static int CU_PARAM_TR_DEFAULT
          For texture references loaded into the module, use default texunit from texture reference
static int CU_STREAM_CALLBACK_BLOCKING
          If set, the stream callback blocks the stream until it is done executing.
static int CU_STREAM_CALLBACK_NONBLOCKING
          Specifies a stream callback does not block the stream while executing.
static int CU_TRSA_OVERRIDE_FORMAT
          Override the texref format with a format inferred from the array
static int CU_TRSF_NORMALIZED_COORDINATES
          Use normalized texture coordinates in the range [0,1) instead of [0,dim)
static int CU_TRSF_READ_AS_INTEGER
          Read the texture as integers rather than promoting the values to floats in the range [0,1]
static int CU_TRSF_SRGB
          Perform sRGB->linear conversion during texture read.
static int CUDA_ARRAY3D_2DARRAY
          Deprecated. use CUDA_ARRAY3D_LAYERED
static int CUDA_ARRAY3D_CUBEMAP
          If set, the CUDA array is a collection of six 2D arrays, representing faces of a cube.
static int CUDA_ARRAY3D_LAYERED
          If set, the CUDA array is a collection of layers, where each layer is either a 1D or a 2D array and the Depth member of CUDA_ARRAY3D_DESCRIPTOR specifies the number of layers, not the depth of a 3D array.
static int CUDA_ARRAY3D_SURFACE_LDST
          This flag must be set in order to bind a surface reference to the CUDA array
static int CUDA_ARRAY3D_TEXTURE_GATHER
          This flag must be set in order to perform texture gather operations on a CUDA array.
static int CUDA_VERSION
          The CUDA version
 
Method Summary
static int align(int value, int alignment)
          Deprecated. This method was intended for a simpler kernel parameter setup in earlier CUDA versions, and should not be required any more. It may be removed in future releases.
static int cuArray3DCreate(CUarray pHandle, CUDA_ARRAY3D_DESCRIPTOR pAllocateArray)
          Creates a 3D CUDA array.
static int cuArray3DGetDescriptor(CUDA_ARRAY3D_DESCRIPTOR pArrayDescriptor, CUarray hArray)
          Get a 3D CUDA array descriptor.
static int cuArrayCreate(CUarray pHandle, CUDA_ARRAY_DESCRIPTOR pAllocateArray)
          Creates a 1D or 2D CUDA array.
static int cuArrayDestroy(CUarray hArray)
          Destroys a CUDA array.
static int cuArrayGetDescriptor(CUDA_ARRAY_DESCRIPTOR pArrayDescriptor, CUarray hArray)
          Get a 1D or 2D CUDA array descriptor.
static int cuCtxAttach(CUcontext pctx, int flags)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuCtxCreate(CUcontext pctx, int flags, CUdevice dev)
          Create a CUDA context.
static int cuCtxDestroy(CUcontext ctx)
          Destroy a CUDA context.
static int cuCtxDetach(CUcontext ctx)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuCtxDisablePeerAccess(CUcontext peerContext)
          Disables direct access to memory allocations in a peer context and unregisters any registered allocations.
static int cuCtxEnablePeerAccess(CUcontext peerContext, int Flags)
          Enables direct access to memory allocations in a peer context.
static int cuCtxGetApiVersion(CUcontext ctx, int[] version)
          Gets the context's API version.
static int cuCtxGetCacheConfig(int[] pconfig)
          Returns the preferred cache configuration for the current context.
static int cuCtxGetCurrent(CUcontext pctx)
          Returns the CUDA context bound to the calling CPU thread.
static int cuCtxGetDevice(CUdevice device)
          Returns the device ID for the current context.
static int cuCtxGetLimit(long[] pvalue, int limit)
          Returns resource limits.
static int cuCtxGetSharedMemConfig(int[] pConfig)
          (Not available in CUDA 4.2) Returns the shared memory configuration
static int cuCtxPopCurrent(CUcontext pctx)
          Pops the current CUDA context from the current CPU thread.
static int cuCtxPushCurrent(CUcontext ctx)
          Pushes a context on the current CPU thread.
static int cuCtxSetCacheConfig(int config)
          Sets the preferred cache configuration for the current context.
static int cuCtxSetCurrent(CUcontext ctx)
          Binds the specified CUDA context to the calling CPU thread.
static int cuCtxSetLimit(int limit, long value)
          Set resource limits.
static int cuCtxSetSharedMemConfig(int config)
          (Not available in CUDA 4.2) Sets the shared memory configuration
static int cuCtxSynchronize()
          Block for a context's tasks to complete.
static int cuDeviceCanAccessPeer(int[] canAccessPeer, CUdevice dev, CUdevice peerDev)
          Queries if a device may directly access a peer device's memory.
static int cuDeviceComputeCapability(int[] major, int[] minor, CUdevice dev)
          Returns the compute capability of the device.
static int cuDeviceGet(CUdevice device, int ordinal)
          Returns a handle to a compute device.
static int cuDeviceGetAttribute(int[] pi, int attrib, CUdevice dev)
          Returns information about the device.
static int cuDeviceGetByPCIBusId(CUdevice dev, java.lang.String pciBusId)
          Returns a handle to a compute device.
static int cuDeviceGetCount(int[] count)
          Returns the number of compute-capable devices.
static int cuDeviceGetName(byte[] name, int len, CUdevice dev)
          Returns an identifer string for the device.
static int cuDeviceGetPCIBusId(java.lang.String[] pciBusId, int len, CUdevice dev)
          Returns a PCI Bus Id string for the device.
static int cuDeviceGetProperties(CUdevprop prop, CUdevice dev)
          Returns properties for a selected device.
static int cuDeviceTotalMem(long[] bytes, CUdevice dev)
          Returns the total amount of memory on the device.
static int cuDriverGetVersion(int[] driverVersion)
          Returns the CUDA driver version.
static int cuEventCreate(CUevent phEvent, int Flags)
          Creates an event.
static int cuEventDestroy(CUevent hEvent)
          Destroys an event.
static int cuEventElapsedTime(float[] pMilliseconds, CUevent hStart, CUevent hEnd)
          Computes the elapsed time between two events.
static int cuEventQuery(CUevent hEvent)
          Queries an event's status.
static int cuEventRecord(CUevent hEvent, CUstream hStream)
          Records an event.
static int cuEventSynchronize(CUevent hEvent)
          Waits for an event to complete.
static int cuFuncGetAttribute(int[] pi, int attrib, CUfunction func)
          Returns information about a function.
static int cuFuncSetBlockShape(CUfunction hfunc, int x, int y, int z)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuFuncSetCacheConfig(CUfunction hfunc, int config)
          Sets the preferred cache configuration for a device function.
static int cuFuncSetSharedMemConfig(CUfunction hfunc, int config)
          (Not available in CUDA 4.2) Sets the shared memory configuration for the given function
static int cuFuncSetSharedSize(CUfunction hfunc, int bytes)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuGLCtxCreate(CUcontext pCtx, int Flags, CUdevice device)
          Create a CUDA context for interoperability with OpenGL.
static int cuGLGetDevices(int[] pCudaDeviceCount, CUdevice[] pCudaDevices, int cudaDeviceCount, int CUGLDeviceList_deviceList)
          Gets the CUDA devices associated with the current OpenGL context.
static int cuGLInit()
          Deprecated. This function is deprecated in the latest CUDA version
static int cuGLMapBufferObject(CUdeviceptr dptr, long[] size, int bufferobj)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuGLMapBufferObjectAsync(CUdeviceptr dptr, long[] size, int buffer, CUstream hStream)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuGLRegisterBufferObject(int bufferobj)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuGLSetBufferObjectMapFlags(int buffer, int Flags)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuGLUnmapBufferObject(int bufferobj)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuGLUnmapBufferObjectAsync(int buffer, CUstream hStream)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuGLUnregisterBufferObject(int bufferobj)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuGraphicsGLRegisterBuffer(CUgraphicsResource pCudaResource, int buffer, int Flags)
          Registers an OpenGL buffer object.
static int cuGraphicsGLRegisterImage(CUgraphicsResource pCudaResource, int image, int target, int Flags)
          Register an OpenGL texture or renderbuffer object.
static int cuGraphicsMapResources(int count, CUgraphicsResource[] resources, CUstream hStream)
          Map graphics resources for access by CUDA.
static int cuGraphicsResourceGetMappedMipmappedArray(CUmipmappedArray pMipmappedArray, CUgraphicsResource resource)
           
static int cuGraphicsResourceGetMappedPointer(CUdeviceptr pDevPtr, long[] pSize, CUgraphicsResource resource)
          Get a device pointer through which to access a mapped graphics resource.
static int cuGraphicsResourceSetMapFlags(CUgraphicsResource resource, int flags)
          Set usage flags for mapping a graphics resource.
static int cuGraphicsSubResourceGetMappedArray(CUarray pArray, CUgraphicsResource resource, int arrayIndex, int mipLevel)
          Get an array through which to access a subresource of a mapped graphics resource.
static int cuGraphicsUnmapResources(int count, CUgraphicsResource[] resources, CUstream hStream)
          Unmap graphics resources.
static int cuGraphicsUnregisterResource(CUgraphicsResource resource)
          Unregisters a graphics resource for access by CUDA.
static int cuInit(int Flags)
          Initialize the CUDA driver API.
static int cuIpcCloseMemHandle(CUdeviceptr dptr)
          Close memory mapped with ::cuIpcOpenMemHandle.
static int cuIpcGetEventHandle(CUipcEventHandle pHandle, CUevent event)
          Gets an interprocess handle for a previously allocated event.
static int cuIpcGetMemHandle(CUipcMemHandle pHandle, CUdeviceptr dptr)
          Gets an interprocess memory handle for an existing device memory allocation.
static int cuIpcOpenEventHandle(CUevent phEvent, CUipcEventHandle handle)
          Opens an interprocess event handle for use in the current process.
static int cuIpcOpenMemHandle(CUdeviceptr pdptr, CUipcMemHandle handle, int Flags)
          Opens an interprocess memory handle exported from another process and returns a device pointer usable in the local process.
static int cuLaunch(CUfunction f)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuLaunchGrid(CUfunction f, int grid_width, int grid_height)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuLaunchGridAsync(CUfunction f, int grid_width, int grid_height, CUstream hStream)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuLaunchKernel(CUfunction f, int gridDimX, int gridDimY, int gridDimZ, int blockDimX, int blockDimY, int blockDimZ, int sharedMemBytes, CUstream hStream, Pointer kernelParams, Pointer extra)
          Launches a CUDA function.
static int cuMemAlloc(CUdeviceptr dptr, long bytesize)
          Allocates device memory.
static int cuMemAllocHost(Pointer pointer, long bytesize)
          Allocates page-locked host memory.
static int cuMemAllocPitch(CUdeviceptr dptr, long[] pPitch, long WidthInBytes, long Height, int ElementSizeBytes)
          Allocates pitched device memory.
static int cuMemcpy(CUdeviceptr dst, CUdeviceptr src, long ByteCount)
          Copies memory.
static int cuMemcpy2D(CUDA_MEMCPY2D pCopy)
          Copies memory for 2D arrays.
static int cuMemcpy2DAsync(CUDA_MEMCPY2D pCopy, CUstream hStream)
          Copies memory for 2D arrays.
static int cuMemcpy2DUnaligned(CUDA_MEMCPY2D pCopy)
          Copies memory for 2D arrays.
static int cuMemcpy3D(CUDA_MEMCPY3D pCopy)
          Copies memory for 3D arrays.
static int cuMemcpy3DAsync(CUDA_MEMCPY3D pCopy, CUstream hStream)
          Copies memory for 3D arrays.
static int cuMemcpy3DPeer(CUDA_MEMCPY3D_PEER pCopy)
          Copies memory between contexts.
static int cuMemcpy3DPeerAsync(CUDA_MEMCPY3D_PEER pCopy, CUstream hStream)
          Copies memory between contexts.
static int cuMemcpyAsync(CUdeviceptr dst, CUdeviceptr src, long ByteCount, CUstream hStream)
          Copies memory asynchronously.
static int cuMemcpyAtoA(CUarray dstArray, long dstIndex, CUarray srcArray, long srcIndex, long ByteCount)
          Copies memory from Array to Array.
static int cuMemcpyAtoD(CUdeviceptr dstDevice, CUarray hSrc, long SrcIndex, long ByteCount)
          Copies memory from Array to Device.
static int cuMemcpyAtoH(Pointer dstHost, CUarray srcArray, long srcIndex, long ByteCount)
          Copies memory from Array to Host.
static int cuMemcpyAtoHAsync(Pointer dstHost, CUarray srcArray, long srcIndex, long ByteCount, CUstream hStream)
          Copies memory from Array to Host.
static int cuMemcpyDtoA(CUarray dstArray, long dstIndex, CUdeviceptr srcDevice, long ByteCount)
          Copies memory from Device to Array.
static int cuMemcpyDtoD(CUdeviceptr dstDevice, CUdeviceptr srcDevice, long ByteCount)
          Copies memory from Device to Device.
static int cuMemcpyDtoDAsync(CUdeviceptr dstDevice, CUdeviceptr srcDevice, long ByteCount, CUstream hStream)
          Copies memory from Device to Device.
static int cuMemcpyDtoH(Pointer dstHost, CUdeviceptr srcDevice, long ByteCount)
          Copies memory from Device to Host.
static int cuMemcpyDtoHAsync(Pointer dstHost, CUdeviceptr srcDevice, long ByteCount, CUstream hStream)
          Copies memory from Device to Host.
static int cuMemcpyHtoA(CUarray dstArray, long dstIndex, Pointer pSrc, long ByteCount)
          Copies memory from Host to Array.
static int cuMemcpyHtoAAsync(CUarray dstArray, long dstIndex, Pointer pSrc, long ByteCount, CUstream hStream)
          Copies memory from Host to Array.
static int cuMemcpyHtoD(CUdeviceptr dstDevice, Pointer srcHost, long ByteCount)
          Copies memory from Host to Device.
static int cuMemcpyHtoDAsync(CUdeviceptr dstDevice, Pointer srcHost, long ByteCount, CUstream hStream)
          Copies memory from Host to Device.
static int cuMemcpyPeer(CUdeviceptr dstDevice, CUcontext dstContext, CUdeviceptr srcDevice, CUcontext srcContext, long ByteCount)
          Copies device memory between two contexts.
static int cuMemcpyPeerAsync(CUdeviceptr dstDevice, CUcontext dstContext, CUdeviceptr srcDevice, CUcontext srcContext, long ByteCount, CUstream hStream)
          Copies device memory between two contexts.
static int cuMemFree(CUdeviceptr dptr)
          Frees device memory.
static int cuMemFreeHost(Pointer p)
          Frees page-locked host memory.
static int cuMemGetAddressRange(CUdeviceptr pbase, long[] psize, CUdeviceptr dptr)
          Get information on memory allocations.
static int cuMemGetInfo(long[] free, long[] total)
          Gets free and total memory.
static int cuMemHostAlloc(Pointer pp, long bytes, int Flags)
          Allocates page-locked host memory.
static int cuMemHostGetDevicePointer(CUdeviceptr ret, Pointer p, int Flags)
          Passes back device pointer of mapped pinned memory.
static int cuMemHostGetFlags(int[] pFlags, Pointer p)
          Passes back flags that were used for a pinned allocation.
static int cuMemHostRegister(Pointer p, long bytesize, int Flags)
          Registers an existing host memory range for use by CUDA.
static int cuMemHostUnregister(Pointer p)
          Unregisters a memory range that was registered with cuMemHostRegister().
static int cuMemsetD16(CUdeviceptr dstDevice, short us, long N)
          Initializes device memory.
static int cuMemsetD16Async(CUdeviceptr dstDevice, short us, long N, CUstream hStream)
          Initializes device memory.
static int cuMemsetD2D16(CUdeviceptr dstDevice, long dstPitch, short us, long Width, long Height)
          Sets device memory.
static int cuMemsetD2D16Async(CUdeviceptr dstDevice, long dstPitch, short us, long Width, long Height, CUstream hStream)
          Initializes device memory.
static int cuMemsetD2D32(CUdeviceptr dstDevice, long dstPitch, int ui, long Width, long Height)
          Sets device memory.
static int cuMemsetD2D32Async(CUdeviceptr dstDevice, long dstPitch, int ui, long Width, long Height, CUstream hStream)
          Initializes device memory.
static int cuMemsetD2D8(CUdeviceptr dstDevice, long dstPitch, byte uc, long Width, long Height)
          Sets device memory.
static int cuMemsetD2D8Async(CUdeviceptr dstDevice, long dstPitch, byte uc, long Width, long Height, CUstream hStream)
          Initializes device memory.
static int cuMemsetD32(CUdeviceptr dstDevice, int ui, long N)
          Sets device memory.
static int cuMemsetD32Async(CUdeviceptr dstDevice, int ui, long N, CUstream hStream)
          Initializes device memory.
static int cuMemsetD8(CUdeviceptr dstDevice, byte uc, long N)
          Sets device memory.
static int cuMemsetD8Async(CUdeviceptr dstDevice, byte uc, long N, CUstream hStream)
          Initializes device memory.
static int cuMipmappedArrayCreate(CUmipmappedArray pHandle, CUDA_ARRAY3D_DESCRIPTOR pMipmappedArrayDesc, int numMipmapLevels)
           
static int cuMipmappedArrayDestroy(CUmipmappedArray hMipmappedArray)
           
static int cuMipmappedArrayGetLevel(CUarray pLevelArray, CUmipmappedArray hMipmappedArray, int level)
           
static int cuModuleGetFunction(CUfunction hfunc, CUmodule hmod, java.lang.String name)
          Returns a function handle.
static int cuModuleGetGlobal(CUdeviceptr dptr, long[] bytes, CUmodule hmod, java.lang.String name)
          Returns a global pointer from a module.
static int cuModuleGetSurfRef(CUsurfref pSurfRef, CUmodule hmod, java.lang.String name)
          Returns a handle to a surface reference.
static int cuModuleGetTexRef(CUtexref pTexRef, CUmodule hmod, java.lang.String name)
          Returns a handle to a texture reference.
static int cuModuleLoad(CUmodule module, java.lang.String fname)
          Loads a compute module.
static int cuModuleLoadData(CUmodule module, byte[] image)
          Load a module's data.
static int cuModuleLoadDataEx(CUmodule phMod, Pointer p, int numOptions, int[] options, Pointer optionValues)
          Load a module's data with options.
static int cuModuleLoadDataJIT(CUmodule module, Pointer pointer, JITOptions jitOptions)
          A wrapper function for cuModuleLoadDataEx(CUmodule, Pointer, int, int[], Pointer) which allows passing in the options for the JIT compiler, and obtaining the output of the JIT compiler via a JITOptions object.
static int cuModuleLoadFatBinary(CUmodule module, byte[] fatCubin)
          Load a module's data.
static int cuModuleUnload(CUmodule hmod)
          Unloads a module.
static int cuParamSetf(CUfunction hfunc, int offset, float value)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuParamSeti(CUfunction hfunc, int offset, int value)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuParamSetSize(CUfunction hfunc, int numbytes)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuParamSetTexRef(CUfunction hfunc, int texunit, CUtexref hTexRef)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuParamSetv(CUfunction hfunc, int offset, Pointer ptr, int numbytes)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuPointerGetAttribute(Pointer data, int attribute, CUdeviceptr ptr)
          Returns information about a pointer.
static int cuProfilerInitialize(java.lang.String configFile, java.lang.String outputFile, int outputMode)
          Initialize the profiling.
static int cuProfilerStart()
          Start the profiling.
static int cuProfilerStop()
          Stop the profiling.
static int cuStreamAddCallback(CUstream hStream, CUstreamCallback callback, java.lang.Object userData, int flags)
           
static int cuStreamCreate(CUstream phStream, int Flags)
          Create a stream.
static int cuStreamDestroy(CUstream hStream)
          Destroys a stream.
static int cuStreamQuery(CUstream hStream)
          Determine status of a compute stream.
static int cuStreamSynchronize(CUstream hStream)
          Wait until a stream's tasks are completed.
static int cuStreamWaitEvent(CUstream hStream, CUevent hEvent, int Flags)
          Make a compute stream wait on an event.
static int cuSurfObjectCreate(CUsurfObject pSurfObject, CUDA_RESOURCE_DESC pResDesc)
           
static int cuSurfObjectDestroy(CUsurfObject surfObject)
           
static int cuSurfObjectGetResourceDesc(CUDA_RESOURCE_DESC pResDesc, CUsurfObject surfObject)
           
static int cuSurfRefGetArray(CUarray phArray, CUsurfref hSurfRef)
          Passes back the CUDA array bound to a surface reference.
static int cuSurfRefSetArray(CUsurfref hSurfRef, CUarray hArray, int Flags)
          Sets the CUDA array for a surface reference.
static int cuTexObjectCreate(CUtexObject pTexObject, CUDA_RESOURCE_DESC pResDesc, CUDA_TEXTURE_DESC pTexDesc, CUDA_RESOURCE_VIEW_DESC pResViewDesc)
           
static int cuTexObjectDestroy(CUtexObject texObject)
           
static int cuTexObjectGetResourceDesc(CUDA_RESOURCE_DESC pResDesc, CUtexObject texObject)
           
static int cuTexObjectGetResourceViewDesc(CUDA_RESOURCE_VIEW_DESC pResViewDesc, CUtexObject texObject)
           
static int cuTexObjectGetTextureDesc(CUDA_TEXTURE_DESC pTexDesc, CUtexObject texObject)
           
static int cuTexRefCreate(CUtexref pTexRef)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuTexRefDestroy(CUtexref hTexRef)
          Deprecated. This function is deprecated in the latest CUDA version
static int cuTexRefGetAddress(CUdeviceptr pdptr, CUtexref hTexRef)
          Gets the address associated with a texture reference.
static int cuTexRefGetAddressMode(int[] pam, CUtexref hTexRef, int dim)
          Gets the addressing mode used by a texture reference.
static int cuTexRefGetArray(CUarray phArray, CUtexref hTexRef)
          Gets the array bound to a texture reference.
static int cuTexRefGetFilterMode(int[] pfm, CUtexref hTexRef)
          Gets the filter-mode used by a texture reference.
static int cuTexRefGetFlags(int[] pFlags, CUtexref hTexRef)
          Gets the flags used by a texture reference.
static int cuTexRefGetFormat(int[] pFormat, int[] pNumChannels, CUtexref hTexRef)
          Gets the format used by a texture reference.
static int cuTexRefGetMaxAnisotropy(int[] pmaxAniso, CUtexref hTexRef)
           
static int cuTexRefGetMipmapFilterMode(int[] pfm, CUtexref hTexRef)
           
static int cuTexRefGetMipmapLevelBias(float[] pbias, CUtexref hTexRef)
           
static int cuTexRefGetMipmapLevelClamp(float[] pminMipmapLevelClamp, float[] pmaxMipmapLevelClamp, CUtexref hTexRef)
           
static int cuTexRefGetMipmappedArray(CUmipmappedArray phMipmappedArray, CUtexref hTexRef)
           
static int cuTexRefSetAddress(long[] ByteOffset, CUtexref hTexRef, CUdeviceptr dptr, long bytes)
          Binds an address as a texture reference.
static int cuTexRefSetAddress2D(CUtexref hTexRef, CUDA_ARRAY_DESCRIPTOR desc, CUdeviceptr dptr, long PitchInBytes)
          Binds an address as a 2D texture reference.
static int cuTexRefSetAddressMode(CUtexref hTexRef, int dim, int am)
          Sets the addressing mode for a texture reference.
static int cuTexRefSetArray(CUtexref hTexRef, CUarray hArray, int Flags)
          Binds an array as a texture reference.
static int cuTexRefSetFilterMode(CUtexref hTexRef, int fm)
          Sets the filtering mode for a texture reference.
static int cuTexRefSetFlags(CUtexref hTexRef, int Flags)
          Sets the flags for a texture reference.
static int cuTexRefSetFormat(CUtexref hTexRef, int fmt, int NumPackedComponents)
          Sets the format for a texture reference.
static int cuTexRefSetMaxAnisotropy(CUtexref hTexRef, int maxAniso)
           
static int cuTexRefSetMipmapFilterMode(CUtexref hTexRef, int fm)
           
static int cuTexRefSetMipmapLevelBias(CUtexref hTexRef, float bias)
           
static int cuTexRefSetMipmapLevelClamp(CUtexref hTexRef, float minMipmapLevelClamp, float maxMipmapLevelClamp)
           
static int cuTexRefSetMipmappedArray(CUtexref hTexRef, CUmipmappedArray hMipmappedArray, int Flags)
           
static void setExceptionsEnabled(boolean enabled)
          Enables or disables exceptions.
static void setLogLevel(LogLevel logLevel)
          Set the specified log level for the JCuda driver library.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

CUDA_VERSION

public static final int CUDA_VERSION
The CUDA version

See Also:
Constant Field Values

CU_MEMHOSTALLOC_PORTABLE

public static final int CU_MEMHOSTALLOC_PORTABLE
If set, host memory is portable between CUDA contexts. Flag for cuMemHostAlloc(jcuda.Pointer, long, int)

See Also:
Constant Field Values

CU_MEMHOSTALLOC_DEVICEMAP

public static final int CU_MEMHOSTALLOC_DEVICEMAP
If set, host memory is mapped into CUDA address space and JCudaDriver#cuMemHostGetDevicePointer may be called on the host pointer. Flag for cuMemHostAlloc(jcuda.Pointer, long, int)

See Also:
Constant Field Values

CU_MEMHOSTALLOC_WRITECOMBINED

public static final int CU_MEMHOSTALLOC_WRITECOMBINED
If set, host memory is allocated as write-combined - fast to write, faster to DMA, slow to read except via SSE4 streaming load instruction (MOVNTDQA). Flag for cuMemHostAlloc(jcuda.Pointer, long, int)

See Also:
Constant Field Values

CU_MEMHOSTREGISTER_PORTABLE

public static final int CU_MEMHOSTREGISTER_PORTABLE
If set, host memory is portable between CUDA contexts. Flag for ::cuMemHostRegister()

See Also:
Constant Field Values

CU_MEMHOSTREGISTER_DEVICEMAP

public static final int CU_MEMHOSTREGISTER_DEVICEMAP
If set, host memory is mapped into CUDA address space and ::cuMemHostGetDevicePointer() may be called on the host pointer. Flag for ::cuMemHostRegister()

See Also:
Constant Field Values

CU_MEMPEERREGISTER_DEVICEMAP

public static final int CU_MEMPEERREGISTER_DEVICEMAP
Deprecated. This value has been added in CUDA 4.0 RC, and removed in CUDA 4.0 RC2
If set, peer memory is mapped into CUDA address space and ::cuMemPeerGetDevicePointer() may be called on the host pointer. Flag for ::cuMemPeerRegister()

See Also:
Constant Field Values

CUDA_ARRAY3D_LAYERED

public static final int CUDA_ARRAY3D_LAYERED
If set, the CUDA array is a collection of layers, where each layer is either a 1D or a 2D array and the Depth member of CUDA_ARRAY3D_DESCRIPTOR specifies the number of layers, not the depth of a 3D array.

See Also:
Constant Field Values

CUDA_ARRAY3D_2DARRAY

public static final int CUDA_ARRAY3D_2DARRAY
Deprecated. use CUDA_ARRAY3D_LAYERED
If set, the CUDA array contains an array of 2D slices and the Depth member of CUDA_ARRAY3D_DESCRIPTOR specifies the number of slices, not the depth of a 3D array.

See Also:
Constant Field Values

CUDA_ARRAY3D_SURFACE_LDST

public static final int CUDA_ARRAY3D_SURFACE_LDST
This flag must be set in order to bind a surface reference to the CUDA array

See Also:
Constant Field Values

CUDA_ARRAY3D_CUBEMAP

public static final int CUDA_ARRAY3D_CUBEMAP
If set, the CUDA array is a collection of six 2D arrays, representing faces of a cube. The width of such a CUDA array must be equal to its height, and Depth must be six. If ::CUDA_ARRAY3D_LAYERED flag is also set, then the CUDA array is a collection of cubemaps and Depth must be a multiple of six.

See Also:
Constant Field Values

CUDA_ARRAY3D_TEXTURE_GATHER

public static final int CUDA_ARRAY3D_TEXTURE_GATHER
This flag must be set in order to perform texture gather operations on a CUDA array.

See Also:
Constant Field Values

CU_PARAM_TR_DEFAULT

public static final int CU_PARAM_TR_DEFAULT
For texture references loaded into the module, use default texunit from texture reference

See Also:
Constant Field Values

CU_TRSA_OVERRIDE_FORMAT

public static final int CU_TRSA_OVERRIDE_FORMAT
Override the texref format with a format inferred from the array

See Also:
Constant Field Values

CU_TRSF_READ_AS_INTEGER

public static final int CU_TRSF_READ_AS_INTEGER
Read the texture as integers rather than promoting the values to floats in the range [0,1]

See Also:
Constant Field Values

CU_TRSF_NORMALIZED_COORDINATES

public static final int CU_TRSF_NORMALIZED_COORDINATES
Use normalized texture coordinates in the range [0,1) instead of [0,dim)

See Also:
Constant Field Values

CU_TRSF_SRGB

public static final int CU_TRSF_SRGB
Perform sRGB->linear conversion during texture read. Flag for JCudaDriver#cuTexRefSetFlags()

See Also:
Constant Field Values

CU_STREAM_CALLBACK_NONBLOCKING

public static final int CU_STREAM_CALLBACK_NONBLOCKING
Specifies a stream callback does not block the stream while executing. This is the default behavior. Flag for cuStreamAddCallback(CUstream, CUstreamCallback, Object, int)

See Also:
Constant Field Values

CU_STREAM_CALLBACK_BLOCKING

public static final int CU_STREAM_CALLBACK_BLOCKING
If set, the stream callback blocks the stream until it is done executing. Flag for cuStreamAddCallback(CUstream, CUstreamCallback, Object, int)

See Also:
Constant Field Values

CU_LAUNCH_PARAM_END

public static final Pointer CU_LAUNCH_PARAM_END
End of array terminator for the \p extra parameter to ::cuLaunchKernel


CU_LAUNCH_PARAM_BUFFER_POINTER

public static final Pointer CU_LAUNCH_PARAM_BUFFER_POINTER
Indicator that the next value in the \p extra parameter to ::cuLaunchKernel will be a pointer to a buffer containing all kernel parameters used for launching kernel \p f. This buffer needs to honor all alignment/padding requirements of the individual parameters. If ::CU_LAUNCH_PARAM_BUFFER_SIZE is not also specified in the \p extra array, then ::CU_LAUNCH_PARAM_BUFFER_POINTER will have no effect.


CU_LAUNCH_PARAM_BUFFER_SIZE

public static final Pointer CU_LAUNCH_PARAM_BUFFER_SIZE
Indicator that the next value in the \p extra parameter to ::cuLaunchKernel will be a pointer to a size_t which contains the size of the buffer specified with ::CU_LAUNCH_PARAM_BUFFER_POINTER. It is required that ::CU_LAUNCH_PARAM_BUFFER_POINTER also be specified in the \p extra array if the value associated with ::CU_LAUNCH_PARAM_BUFFER_SIZE is not zero.

Method Detail

setLogLevel

public static void setLogLevel(LogLevel logLevel)
Set the specified log level for the JCuda driver library.

Currently supported log levels:
LOG_QUIET: Never print anything
LOG_ERROR: Print error messages
LOG_TRACE: Print a trace of all native function calls

Parameters:
logLevel - The log level to use.

setExceptionsEnabled

public static void setExceptionsEnabled(boolean enabled)
Enables or disables exceptions. By default, the methods of this class only return the CUresult error code from the underlying CUDA function. If exceptions are enabled, a CudaException with a detailed error message will be thrown if a method is about to return a result code that is not CUresult.CUDA_SUCCESS

Parameters:
enabled - Whether exceptions are enabled

align

public static int align(int value,
                        int alignment)
Deprecated. This method was intended for a simpler kernel parameter setup in earlier CUDA versions, and should not be required any more. It may be removed in future releases.

Returns the given (address) value, adjusted to have the given alignment. This function may be used to align the parameters for a kernel call according to their alignment requirements.

Parameters:
value - The address value
alignment - The desired alignment
Returns:
The aligned address value

cuModuleLoadDataJIT

public static int cuModuleLoadDataJIT(CUmodule module,
                                      Pointer pointer,
                                      JITOptions jitOptions)
A wrapper function for cuModuleLoadDataEx(CUmodule, Pointer, int, int[], Pointer) which allows passing in the options for the JIT compiler, and obtaining the output of the JIT compiler via a JITOptions object.

Note: This method should be considered as preliminary, and might change in future releases.

See Also:
cuModuleLoadDataEx(jcuda.driver.CUmodule, jcuda.Pointer, int, int[], jcuda.Pointer)

cuInit

public static int cuInit(int Flags)
Initialize the CUDA driver API.
CUresult cuInit ( unsigned int  Flags  ) 

Initializes the driver API and must be called before any other function from the driver API. Currently, the Flags parameter must be 0. If cuInit() has not been called, any function from the driver API will return CUDA_ERROR_NOT_INITIALIZED.

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE

cuDeviceGet

public static int cuDeviceGet(CUdevice device,
                              int ordinal)
Returns a handle to a compute device.
CUresult cuDeviceGet ( CUdevice *  device,
int  ordinal  
)

Returns in *device a device handle given an ordinal in the range [0, cuDeviceGetCount()-1].

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE
See Also:
cuDeviceComputeCapability(int[], int[], jcuda.driver.CUdevice), cuDeviceGetAttribute(int[], int, jcuda.driver.CUdevice), cuDeviceGetCount(int[]), cuDeviceGetName(byte[], int, jcuda.driver.CUdevice), cuDeviceGetProperties(jcuda.driver.CUdevprop, jcuda.driver.CUdevice), cuDeviceTotalMem(long[], jcuda.driver.CUdevice)

cuDeviceGetCount

public static int cuDeviceGetCount(int[] count)
Returns the number of compute-capable devices.
CUresult cuDeviceGetCount ( int *  count  ) 

Returns in *count the number of devices with compute capability greater than or equal to 1.0 that are available for execution. If there is no such device, cuDeviceGetCount() returns 0.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuDeviceComputeCapability(int[], int[], jcuda.driver.CUdevice), cuDeviceGetAttribute(int[], int, jcuda.driver.CUdevice), cuDeviceGetName(byte[], int, jcuda.driver.CUdevice), cuDeviceGet(jcuda.driver.CUdevice, int), cuDeviceGetProperties(jcuda.driver.CUdevprop, jcuda.driver.CUdevice), cuDeviceTotalMem(long[], jcuda.driver.CUdevice)

cuDeviceGetName

public static int cuDeviceGetName(byte[] name,
                                  int len,
                                  CUdevice dev)
Returns an identifer string for the device.
CUresult cuDeviceGetName ( char *  name,
int  len,
CUdevice  dev  
)

Returns an ASCII string identifying the device dev in the NULL-terminated string pointed to by name. len specifies the maximum length of the string that may be returned.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE
See Also:
cuDeviceComputeCapability(int[], int[], jcuda.driver.CUdevice), cuDeviceGetAttribute(int[], int, jcuda.driver.CUdevice), cuDeviceGetCount(int[]), cuDeviceGet(jcuda.driver.CUdevice, int), cuDeviceGetProperties(jcuda.driver.CUdevprop, jcuda.driver.CUdevice), cuDeviceTotalMem(long[], jcuda.driver.CUdevice)

cuDeviceComputeCapability

public static int cuDeviceComputeCapability(int[] major,
                                            int[] minor,
                                            CUdevice dev)
Returns the compute capability of the device.
CUresult cuDeviceComputeCapability ( int *  major,
int *  minor,
CUdevice  dev  
)

Returns in *major and *minor the major and minor revision numbers that define the compute capability of the device dev.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE
See Also:
cuDeviceGetAttribute(int[], int, jcuda.driver.CUdevice), cuDeviceGetCount(int[]), cuDeviceGetName(byte[], int, jcuda.driver.CUdevice), cuDeviceGet(jcuda.driver.CUdevice, int), cuDeviceGetProperties(jcuda.driver.CUdevprop, jcuda.driver.CUdevice), cuDeviceTotalMem(long[], jcuda.driver.CUdevice)

cuDeviceTotalMem

public static int cuDeviceTotalMem(long[] bytes,
                                   CUdevice dev)
Returns the total amount of memory on the device.
CUresult cuDeviceTotalMem ( size_t *  bytes,
CUdevice  dev  
)

Returns in *bytes the total amount of memory available on the device dev in bytes.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE
See Also:
cuDeviceComputeCapability(int[], int[], jcuda.driver.CUdevice), cuDeviceGetAttribute(int[], int, jcuda.driver.CUdevice), cuDeviceGetCount(int[]), cuDeviceGetName(byte[], int, jcuda.driver.CUdevice), cuDeviceGet(jcuda.driver.CUdevice, int), cuDeviceGetProperties(jcuda.driver.CUdevprop, jcuda.driver.CUdevice)

cuDeviceGetProperties

public static int cuDeviceGetProperties(CUdevprop prop,
                                        CUdevice dev)
Returns properties for a selected device.
CUresult cuDeviceGetProperties ( CUdevprop *  prop,
CUdevice  dev  
)

Returns in *prop the properties of device dev. The CUdevprop structure is defined as:

     typedef struct CUdevprop_st
 {
      int maxThreadsPerBlock;
      int maxThreadsDim[3];
      int maxGridSize[3];
      int sharedMemPerBlock;
      int totalConstantMemory;
      int SIMDWidth;
      int memPitch;
      int regsPerBlock;
      int clockRate;
      int textureAlign
   } CUdevprop;
 
where:

  • maxThreadsPerBlock is the maximum number of threads per block;
  • maxThreadsDim[3] is the maximum sizes of each dimension of a block;
  • maxGridSize[3] is the maximum sizes of each dimension of a grid;
  • sharedMemPerBlock is the total amount of shared memory available per block in bytes;
  • totalConstantMemory is the total amount of constant memory available on the device in bytes;
  • SIMDWidth is the warp size;
  • memPitch is the maximum pitch allowed by the memory copy functions that involve memory regions allocated through cuMemAllocPitch();
  • regsPerBlock is the total number of registers available per block;
  • clockRate is the clock frequency in kilohertz;
  • textureAlign is the alignment requirement; texture base addresses that are aligned to textureAlign bytes do not need an offset applied to texture fetches.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE
See Also:
cuDeviceComputeCapability(int[], int[], jcuda.driver.CUdevice), cuDeviceGetAttribute(int[], int, jcuda.driver.CUdevice), cuDeviceGetCount(int[]), cuDeviceGetName(byte[], int, jcuda.driver.CUdevice), cuDeviceGet(jcuda.driver.CUdevice, int), cuDeviceTotalMem(long[], jcuda.driver.CUdevice)

cuDeviceGetAttribute

public static int cuDeviceGetAttribute(int[] pi,
                                       int attrib,
                                       CUdevice dev)
Returns information about the device.
CUresult cuDeviceGetAttribute ( int *  pi,
CUdevice_attribute  attrib,
CUdevice  dev  
)

Returns in *pi the integer value of the attribute attrib on device dev. The supported attributes are:

  • CU_DEVICE_ATTRIBUTE_MAX_THREADS_PER_BLOCK: Maximum number of threads per block;
  • CU_DEVICE_ATTRIBUTE_MAX_BLOCK_DIM_X: Maximum x-dimension of a block;
  • CU_DEVICE_ATTRIBUTE_MAX_BLOCK_DIM_Y: Maximum y-dimension of a block;
  • CU_DEVICE_ATTRIBUTE_MAX_BLOCK_DIM_Z: Maximum z-dimension of a block;
  • CU_DEVICE_ATTRIBUTE_MAX_GRID_DIM_X: Maximum x-dimension of a grid;
  • CU_DEVICE_ATTRIBUTE_MAX_GRID_DIM_Y: Maximum y-dimension of a grid;
  • CU_DEVICE_ATTRIBUTE_MAX_GRID_DIM_Z: Maximum z-dimension of a grid;
  • CU_DEVICE_ATTRIBUTE_MAX_SHARED_MEMORY_PER_BLOCK: Maximum amount of shared memory available to a thread block in bytes; this amount is shared by all thread blocks simultaneously resident on a multiprocessor;
  • CU_DEVICE_ATTRIBUTE_TOTAL_CONSTANT_MEMORY: Memory available on device for __constant__ variables in a CUDA C kernel in bytes;
  • CU_DEVICE_ATTRIBUTE_WARP_SIZE: Warp size in threads;
  • CU_DEVICE_ATTRIBUTE_MAX_PITCH: Maximum pitch in bytes allowed by the memory copy functions that involve memory regions allocated through cuMemAllocPitch();
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE1D_WIDTH: Maximum 1D texture width;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE1D_LINEAR_WIDTH: Maximum width for a 1D texture bound to linear memory;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_WIDTH: Maximum 2D texture width;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_HEIGHT: Maximum 2D texture height;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_WIDTH: Maximum width for a 2D texture bound to linear memory;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_HEIGHT: Maximum height for a 2D texture bound to linear memory;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_PITCH: Maximum pitch in bytes for a 2D texture bound to linear memory;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE3D_WIDTH: Maximum 3D texture width;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE3D_HEIGHT: Maximum 3D texture height;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE3D_DEPTH: Maximum 3D texture depth;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE3D_WIDTH_ALTERNATE: Alternate maximum 3D texture width, 0 if no alternate maximum 3D texture size is supported;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE3D_HEIGHT_ALTERNATE: Alternate maximum 3D texture height, 0 if no alternate maximum 3D texture size is supported;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE3D_DEPTH_ALTERNATE: Alternate maximum 3D texture depth, 0 if no alternate maximum 3D texture size is supported;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURECUBEMAP_WIDTH: Maximum cubemap texture width or height;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE1D_LAYERED_WIDTH: Maximum 1D layered texture width;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE1D_LAYERED_LAYERS: Maximum layers in a 1D layered texture;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LAYERED_WIDTH: Maximum 2D layered texture width;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LAYERED_HEIGHT: Maximum 2D layered texture height;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LAYERED_LAYERS: Maximum layers in a 2D layered texture;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURECUBEMAP_LAYERED_WIDTH: Maximum cubemap layered texture width or height;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURECUBEMAP_LAYERED_LAYERS: Maximum layers in a cubemap layered texture;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACE1D_WIDTH: Maximum 1D surface width;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACE2D_WIDTH: Maximum 2D surface width;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACE2D_HEIGHT: Maximum 2D surface height;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACE3D_WIDTH: Maximum 3D surface width;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACE3D_HEIGHT: Maximum 3D surface height;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACE3D_DEPTH: Maximum 3D surface depth;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACE1D_LAYERED_WIDTH: Maximum 1D layered surface width;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACE1D_LAYERED_LAYERS: Maximum layers in a 1D layered surface;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACE2D_LAYERED_WIDTH: Maximum 2D layered surface width;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACE2D_LAYERED_HEIGHT: Maximum 2D layered surface height;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACE2D_LAYERED_LAYERS: Maximum layers in a 2D layered surface;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACECUBEMAP_WIDTH: Maximum cubemap surface width;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACECUBEMAP_LAYERED_WIDTH: Maximum cubemap layered surface width;
  • CU_DEVICE_ATTRIBUTE_MAXIMUM_SURFACECUBEMAP_LAYERED_LAYERS: Maximum layers in a cubemap layered surface;
  • CU_DEVICE_ATTRIBUTE_MAX_REGISTERS_PER_BLOCK: Maximum number of 32-bit registers available to a thread block; this number is shared by all thread blocks simultaneously resident on a multiprocessor;
  • CU_DEVICE_ATTRIBUTE_CLOCK_RATE: Peak clock frequency in kilohertz;
  • CU_DEVICE_ATTRIBUTE_TEXTURE_ALIGNMENT: Alignment requirement; texture base addresses aligned to textureAlign bytes do not need an offset applied to texture fetches;
  • CU_DEVICE_ATTRIBUTE_TEXTURE_PITCH_ALIGNMENT: Pitch alignment requirement for 2D texture references bound to pitched memory;
  • CU_DEVICE_ATTRIBUTE_GPU_OVERLAP: 1 if the device can concurrently copy memory between host and device while executing a kernel, or 0 if not;
  • CU_DEVICE_ATTRIBUTE_MULTIPROCESSOR_COUNT: Number of multiprocessors on the device;
  • CU_DEVICE_ATTRIBUTE_KERNEL_EXEC_TIMEOUT: 1 if there is a run time limit for kernels executed on the device, or 0 if not;
  • CU_DEVICE_ATTRIBUTE_INTEGRATED: 1 if the device is integrated with the memory subsystem, or 0 if not;
  • CU_DEVICE_ATTRIBUTE_CAN_MAP_HOST_MEMORY: 1 if the device can map host memory into the CUDA address space, or 0 if not;
  • CU_DEVICE_ATTRIBUTE_COMPUTE_MODE: Compute mode that device is currently in. Available modes are as follows:
    • CU_COMPUTEMODE_DEFAULT: Default mode - Device is not restricted and can have multiple CUDA contexts present at a single time.
    • CU_COMPUTEMODE_EXCLUSIVE: Compute-exclusive mode - Device can have only one CUDA context present on it at a time.
    • CU_COMPUTEMODE_PROHIBITED: Compute-prohibited mode - Device is prohibited from creating new CUDA contexts.
    • CU_COMPUTEMODE_EXCLUSIVE_PROCESS: Compute-exclusive-process mode - Device can have only one context used by a single process at a time.
  • CU_DEVICE_ATTRIBUTE_CONCURRENT_KERNELS: 1 if the device supports executing multiple kernels within the same context simultaneously, or 0 if not. It is not guaranteed that multiple kernels will be resident on the device concurrently so this feature should not be relied upon for correctness;
  • CU_DEVICE_ATTRIBUTE_ECC_ENABLED: 1 if error correction is enabled on the device, 0 if error correction is disabled or not supported by the device;
  • CU_DEVICE_ATTRIBUTE_PCI_BUS_ID: PCI bus identifier of the device;
  • CU_DEVICE_ATTRIBUTE_PCI_DEVICE_ID: PCI device (also known as slot) identifier of the device;
  • CU_DEVICE_ATTRIBUTE_TCC_DRIVER: 1 if the device is using a TCC driver. TCC is only available on Tesla hardware running Windows Vista or later;
  • CU_DEVICE_ATTRIBUTE_MEMORY_CLOCK_RATE: Peak memory clock frequency in kilohertz;
  • CU_DEVICE_ATTRIBUTE_GLOBAL_MEMORY_BUS_WIDTH: Global memory bus width in bits;
  • CU_DEVICE_ATTRIBUTE_L2_CACHE_SIZE: Size of L2 cache in bytes. 0 if the device doesn't have L2 cache;
  • CU_DEVICE_ATTRIBUTE_MAX_THREADS_PER_MULTIPROCESSOR: Maximum resident threads per multiprocessor;
  • CU_DEVICE_ATTRIBUTE_UNIFIED_ADDRESSING: 1 if the device shares a unified address space with the host, or 0 if not;

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE
See Also:
cuDeviceComputeCapability(int[], int[], jcuda.driver.CUdevice), cuDeviceGetCount(int[]), cuDeviceGetName(byte[], int, jcuda.driver.CUdevice), cuDeviceGet(jcuda.driver.CUdevice, int), cuDeviceGetProperties(jcuda.driver.CUdevprop, jcuda.driver.CUdevice), cuDeviceTotalMem(long[], jcuda.driver.CUdevice)

cuDriverGetVersion

public static int cuDriverGetVersion(int[] driverVersion)
Returns the CUDA driver version.
CUresult cuDriverGetVersion ( int *  driverVersion  ) 

Returns in *driverVersion the version number of the installed CUDA driver. This function automatically returns CUDA_ERROR_INVALID_VALUE if the driverVersion argument is NULL.

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_VALUE

cuCtxCreate

public static int cuCtxCreate(CUcontext pctx,
                              int flags,
                              CUdevice dev)
Create a CUDA context.
CUresult cuCtxCreate ( CUcontext *  pctx,
unsigned int  flags,
CUdevice  dev  
)

Creates a new CUDA context and associates it with the calling thread. The flags parameter is described below. The context is created with a usage count of 1 and the caller of cuCtxCreate() must call cuCtxDestroy() or when done using the context. If a context is already current to the thread, it is supplanted by the newly created context and may be restored by a subsequent call to cuCtxPopCurrent().

The three LSBs of the flags parameter can be used to control how the OS thread, which owns the CUDA context at the time of an API call, interacts with the OS scheduler when waiting for results from the GPU. Only one of the scheduling flags can be set when creating a context.

  • CU_CTX_SCHED_AUTO: The default value if the flags parameter is zero, uses a heuristic based on the number of active CUDA contexts in the process C and the number of logical processors in the system P. If C > P, then CUDA will yield to other OS threads when waiting for the GPU, otherwise CUDA will not yield while waiting for results and actively spin on the processor.

  • CU_CTX_SCHED_SPIN: Instruct CUDA to actively spin when waiting for results from the GPU. This can decrease latency when waiting for the GPU, but may lower the performance of CPU threads if they are performing work in parallel with the CUDA thread.

  • CU_CTX_SCHED_YIELD: Instruct CUDA to yield its thread when waiting for results from the GPU. This can increase latency when waiting for the GPU, but can increase the performance of CPU threads performing work in parallel with the GPU.

  • CU_CTX_SCHED_BLOCKING_SYNC: Instruct CUDA to block the CPU thread on a synchronization primitive when waiting for the GPU to finish work.

  • CU_CTX_BLOCKING_SYNC: Instruct CUDA to block the CPU thread on a synchronization primitive when waiting for the GPU to finish work.
    Deprecated: This flag was deprecated as of CUDA 4.0 and was replaced with CU_CTX_SCHED_BLOCKING_SYNC.

  • CU_CTX_MAP_HOST: Instruct CUDA to support mapped pinned allocations. This flag must be set in order to allocate pinned host memory that is accessible to the GPU.

  • CU_CTX_LMEM_RESIZE_TO_MAX: Instruct CUDA to not reduce local memory after resizing local memory for a kernel. This can prevent thrashing by local memory allocations when launching many kernels with high local memory usage at the cost of potentially increased memory usage.

Context creation will fail with CUDA_ERROR_UNKNOWN if the compute mode of the device is CU_COMPUTEMODE_PROHIBITED. Similarly, context creation will also fail with CUDA_ERROR_UNKNOWN if the compute mode for the device is set to CU_COMPUTEMODE_EXCLUSIVE and there is already an active context on the device. The function cuDeviceGetAttribute() can be used with CU_DEVICE_ATTRIBUTE_COMPUTE_MODE to determine the compute mode of the device. The nvidia-smi tool can be used to set the compute mode for devices. Documentation for nvidia-smi can be obtained by passing a -h option to it.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_DEVICE, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY, CUDA_ERROR_UNKNOWN
See Also:
cuCtxDestroy(jcuda.driver.CUcontext), cuCtxGetApiVersion(jcuda.driver.CUcontext, int[]), cuCtxGetCacheConfig(int[]), cuCtxGetDevice(jcuda.driver.CUdevice), cuCtxGetLimit(long[], int), cuCtxPopCurrent(jcuda.driver.CUcontext), cuCtxPushCurrent(jcuda.driver.CUcontext), cuCtxSetCacheConfig(int), cuCtxSetLimit(int, long), cuCtxSynchronize()

cuCtxDestroy

public static int cuCtxDestroy(CUcontext ctx)
Destroy a CUDA context.
CUresult cuCtxDestroy ( CUcontext  ctx  ) 

Destroys the CUDA context specified by ctx. The context ctx will be destroyed regardless of how many threads it is current to. It is the caller's responsibility to ensure that no API call is issued to ctx while cuCtxDestroy() is executing.

If ctx is current to the calling thread then ctx will also be popped from the current thread's context stack (as though cuCtxPopCurrent() were called). If ctx is current to other threads, then ctx will remain current to those threads, and attempting to access ctx from those threads will result in the error CUDA_ERROR_CONTEXT_IS_DESTROYED.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxGetApiVersion(jcuda.driver.CUcontext, int[]), cuCtxGetCacheConfig(int[]), cuCtxGetDevice(jcuda.driver.CUdevice), cuCtxGetLimit(long[], int), cuCtxPopCurrent(jcuda.driver.CUcontext), cuCtxPushCurrent(jcuda.driver.CUcontext), cuCtxSetCacheConfig(int), cuCtxSetLimit(int, long), cuCtxSynchronize()

cuCtxAttach

public static int cuCtxAttach(CUcontext pctx,
                              int flags)
Deprecated. This function is deprecated in the latest CUDA version

Increment a context's usage-count.
CUresult cuCtxAttach ( CUcontext *  pctx,
unsigned int  flags  
)

Deprecated:
Note that this function is deprecated and should not be used.

Increments the usage count of the context and passes back a context handle in *pctx that must be passed to cuCtxDetach() when the application is done with the context. cuCtxAttach() fails if there is no context current to the thread.

Currently, the flags parameter must be 0.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext), cuCtxDetach(jcuda.driver.CUcontext), cuCtxGetApiVersion(jcuda.driver.CUcontext, int[]), cuCtxGetCacheConfig(int[]), cuCtxGetDevice(jcuda.driver.CUdevice), cuCtxGetLimit(long[], int), cuCtxPopCurrent(jcuda.driver.CUcontext), cuCtxPushCurrent(jcuda.driver.CUcontext), cuCtxSetCacheConfig(int), cuCtxSetLimit(int, long), cuCtxSynchronize()

cuCtxDetach

public static int cuCtxDetach(CUcontext ctx)
Deprecated. This function is deprecated in the latest CUDA version

Decrement a context's usage-count.
CUresult cuCtxDetach ( CUcontext  ctx  ) 

Deprecated:
Note that this function is deprecated and should not be used.

Decrements the usage count of the context ctx, and destroys the context if the usage count goes to 0. The context must be a handle that was passed back by cuCtxCreate() or cuCtxAttach(), and must be current to the calling thread.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext), cuCtxGetApiVersion(jcuda.driver.CUcontext, int[]), cuCtxGetCacheConfig(int[]), cuCtxGetDevice(jcuda.driver.CUdevice), cuCtxGetLimit(long[], int), cuCtxPopCurrent(jcuda.driver.CUcontext), cuCtxPushCurrent(jcuda.driver.CUcontext), cuCtxSetCacheConfig(int), cuCtxSetLimit(int, long), cuCtxSynchronize()

cuCtxPushCurrent

public static int cuCtxPushCurrent(CUcontext ctx)
Pushes a context on the current CPU thread.
CUresult cuCtxPushCurrent ( CUcontext  ctx  ) 

Pushes the given context ctx onto the CPU thread's stack of current contexts. The specified context becomes the CPU thread's current context, so all CUDA functions that operate on the current context are affected.

The previous current context may be made current again by calling cuCtxDestroy() or cuCtxPopCurrent().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext), cuCtxGetApiVersion(jcuda.driver.CUcontext, int[]), cuCtxGetCacheConfig(int[]), cuCtxGetDevice(jcuda.driver.CUdevice), cuCtxGetLimit(long[], int), cuCtxPopCurrent(jcuda.driver.CUcontext), cuCtxSetCacheConfig(int), cuCtxSetLimit(int, long), cuCtxSynchronize()

cuCtxPopCurrent

public static int cuCtxPopCurrent(CUcontext pctx)
Pops the current CUDA context from the current CPU thread.
CUresult cuCtxPopCurrent ( CUcontext *  pctx  ) 

Pops the current CUDA context from the CPU thread and passes back the old context handle in *pctx. That context may then be made current to a different CPU thread by calling cuCtxPushCurrent().

If a context was current to the CPU thread before cuCtxCreate() or cuCtxPushCurrent() was called, this function makes that context current to the CPU thread again.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext), cuCtxGetApiVersion(jcuda.driver.CUcontext, int[]), cuCtxGetCacheConfig(int[]), cuCtxGetDevice(jcuda.driver.CUdevice), cuCtxGetLimit(long[], int), cuCtxPushCurrent(jcuda.driver.CUcontext), cuCtxSetCacheConfig(int), cuCtxSetLimit(int, long), cuCtxSynchronize()

cuCtxSetCurrent

public static int cuCtxSetCurrent(CUcontext ctx)
Binds the specified CUDA context to the calling CPU thread.
CUresult cuCtxSetCurrent ( CUcontext  ctx  ) 

Binds the specified CUDA context to the calling CPU thread. If ctx is NULL then the CUDA context previously bound to the calling CPU thread is unbound and CUDA_SUCCESS is returned.

If there exists a CUDA context stack on the calling CPU thread, this will replace the top of that stack with ctx. If ctx is NULL then this will be equivalent to popping the top of the calling CPU thread's CUDA context stack (or a no-op if the calling CPU thread's CUDA context stack is empty).

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT
See Also:
cuCtxGetCurrent(jcuda.driver.CUcontext), cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext)

cuCtxGetCurrent

public static int cuCtxGetCurrent(CUcontext pctx)
Returns the CUDA context bound to the calling CPU thread.
CUresult cuCtxGetCurrent ( CUcontext *  pctx  ) 

Returns in *pctx the CUDA context bound to the calling CPU thread. If no context is bound to the calling CPU thread then *pctx is set to NULL and CUDA_SUCCESS is returned.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED,
See Also:
cuCtxSetCurrent(jcuda.driver.CUcontext), cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext)

cuCtxGetDevice

public static int cuCtxGetDevice(CUdevice device)
Returns the device ID for the current context.
CUresult cuCtxGetDevice ( CUdevice *  device  ) 

Returns in *device the ordinal of the current context's device.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE,
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext), cuCtxGetApiVersion(jcuda.driver.CUcontext, int[]), cuCtxGetCacheConfig(int[]), cuCtxGetLimit(long[], int), cuCtxPopCurrent(jcuda.driver.CUcontext), cuCtxPushCurrent(jcuda.driver.CUcontext), cuCtxSetCacheConfig(int), cuCtxSetLimit(int, long), cuCtxSynchronize()

cuCtxSynchronize

public static int cuCtxSynchronize()
Block for a context's tasks to complete.
CUresult cuCtxSynchronize ( void   ) 

Blocks until the device has completed all preceding requested tasks. cuCtxSynchronize() returns an error if one of the preceding tasks failed. If the context was created with the CU_CTX_SCHED_BLOCKING_SYNC flag, the CPU thread will block until the GPU context has finished its work.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext), cuCtxGetApiVersion(jcuda.driver.CUcontext, int[]), cuCtxGetCacheConfig(int[]), cuCtxGetDevice(jcuda.driver.CUdevice), cuCtxGetLimit(long[], int), cuCtxPopCurrent(jcuda.driver.CUcontext), cuCtxPushCurrent(jcuda.driver.CUcontext), cuCtxSetLimit(int, long)

cuModuleLoad

public static int cuModuleLoad(CUmodule module,
                               java.lang.String fname)
Loads a compute module.
CUresult cuModuleLoad ( CUmodule *  module,
const char *  fname  
)

Takes a filename fname and loads the corresponding module module into the current context. The CUDA driver API does not attempt to lazily allocate the resources needed by a module; if the memory for functions and data (constant and global) needed by the module cannot be allocated, cuModuleLoad() fails. The file should be a cubin file as output by nvcc, or a PTX file either as output by nvcc or handwritten, or a fatbin file as output by nvcc from toolchain 4.0 or later.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_NOT_FOUND, CUDA_ERROR_OUT_OF_MEMORY, CUDA_ERROR_FILE_NOT_FOUND, CUDA_ERROR_SHARED_OBJECT_SYMBOL_NOT_FOUND, CUDA_ERROR_SHARED_OBJECT_INIT_FAILED
See Also:
cuModuleGetFunction(jcuda.driver.CUfunction, jcuda.driver.CUmodule, java.lang.String), cuModuleGetGlobal(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUmodule, java.lang.String), cuModuleGetTexRef(jcuda.driver.CUtexref, jcuda.driver.CUmodule, java.lang.String), cuModuleLoadData(jcuda.driver.CUmodule, byte[]), cuModuleLoadDataEx(jcuda.driver.CUmodule, jcuda.Pointer, int, int[], jcuda.Pointer), cuModuleLoadFatBinary(jcuda.driver.CUmodule, byte[]), cuModuleUnload(jcuda.driver.CUmodule)

cuModuleLoadData

public static int cuModuleLoadData(CUmodule module,
                                   byte[] image)
Load a module's data.
CUresult cuModuleLoadData ( CUmodule *  module,
const void *  image  
)

Takes a pointer image and loads the corresponding module module into the current context. The pointer may be obtained by mapping a cubin or PTX or fatbin file, passing a cubin or PTX or fatbin file as a NULL-terminated text string, or incorporating a cubin or fatbin object into the executable resources and using operating system calls such as Windows FindResource() to obtain the pointer.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY, CUDA_ERROR_SHARED_OBJECT_SYMBOL_NOT_FOUND, CUDA_ERROR_SHARED_OBJECT_INIT_FAILED
See Also:
cuModuleGetFunction(jcuda.driver.CUfunction, jcuda.driver.CUmodule, java.lang.String), cuModuleGetGlobal(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUmodule, java.lang.String), cuModuleGetTexRef(jcuda.driver.CUtexref, jcuda.driver.CUmodule, java.lang.String), cuModuleLoad(jcuda.driver.CUmodule, java.lang.String), cuModuleLoadDataEx(jcuda.driver.CUmodule, jcuda.Pointer, int, int[], jcuda.Pointer), cuModuleLoadFatBinary(jcuda.driver.CUmodule, byte[]), cuModuleUnload(jcuda.driver.CUmodule)

cuModuleLoadDataEx

public static int cuModuleLoadDataEx(CUmodule phMod,
                                     Pointer p,
                                     int numOptions,
                                     int[] options,
                                     Pointer optionValues)
Load a module's data with options.
CUresult cuModuleLoadDataEx ( CUmodule *  module,
const void *  image,
unsigned int  numOptions,
CUjit_option *  options,
void **  optionValues  
)

Takes a pointer image and loads the corresponding module module into the current context. The pointer may be obtained by mapping a cubin or PTX or fatbin file, passing a cubin or PTX or fatbin file as a NULL-terminated text string, or incorporating a cubin or fatbin object into the executable resources and using operating system calls such as Windows FindResource() to obtain the pointer. Options are passed as an array via options and any corresponding parameters are passed in optionValues. The number of total options is supplied via numOptions. Any outputs will be returned via optionValues. Supported options are (types for the option values are specified in parentheses after the option name):

  • CU_JIT_MAX_REGISTERS: (unsigned int) input specifies the maximum number of registers per thread;
  • CU_JIT_THREADS_PER_BLOCK: (unsigned int) input specifies number of threads per block to target compilation for; output returns the number of threads the compiler actually targeted;
  • CU_JIT_WALL_TIME: (float) output returns the float value of wall clock time, in milliseconds, spent compiling the PTX code;
  • CU_JIT_INFO_LOG_BUFFER: (char*) input is a pointer to a buffer in which to print any informational log messages from PTX assembly (the buffer size is specified via option CU_JIT_INFO_LOG_BUFFER_SIZE_BYTES);
  • CU_JIT_INFO_LOG_BUFFER_SIZE_BYTES: (unsigned int) input is the size in bytes of the buffer; output is the number of bytes filled with messages;
  • CU_JIT_ERROR_LOG_BUFFER: (char*) input is a pointer to a buffer in which to print any error log messages from PTX assembly (the buffer size is specified via option CU_JIT_ERROR_LOG_BUFFER_SIZE_BYTES);
  • CU_JIT_ERROR_LOG_BUFFER_SIZE_BYTES: (unsigned int) input is the size in bytes of the buffer; output is the number of bytes filled with messages;
  • CU_JIT_OPTIMIZATION_LEVEL: (unsigned int) input is the level of optimization to apply to generated code (0 - 4), with 4 being the default and highest level;
  • CU_JIT_TARGET_FROM_CUCONTEXT: (No option value) causes compilation target to be determined based on current attached context (default);
  • CU_JIT_TARGET: (unsigned int for enumerated type CUjit_target_enum) input is the compilation target based on supplied CUjit_target_enum; possible values are:
    • CU_TARGET_COMPUTE_10
    • CU_TARGET_COMPUTE_11
    • CU_TARGET_COMPUTE_12
    • CU_TARGET_COMPUTE_13
    • CU_TARGET_COMPUTE_20
  • CU_JIT_FALLBACK_STRATEGY: (unsigned int for enumerated type CUjit_fallback_enum) chooses fallback strategy if matching cubin is not found; possible values are:
    • CU_PREFER_PTX
    • CU_PREFER_BINARY

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY, CUDA_ERROR_NO_BINARY_FOR_GPU, CUDA_ERROR_SHARED_OBJECT_SYMBOL_NOT_FOUND, CUDA_ERROR_SHARED_OBJECT_INIT_FAILED
See Also:
cuModuleGetFunction(jcuda.driver.CUfunction, jcuda.driver.CUmodule, java.lang.String), cuModuleGetGlobal(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUmodule, java.lang.String), cuModuleGetTexRef(jcuda.driver.CUtexref, jcuda.driver.CUmodule, java.lang.String), cuModuleLoad(jcuda.driver.CUmodule, java.lang.String), cuModuleLoadData(jcuda.driver.CUmodule, byte[]), cuModuleLoadFatBinary(jcuda.driver.CUmodule, byte[]), cuModuleUnload(jcuda.driver.CUmodule)

cuModuleLoadFatBinary

public static int cuModuleLoadFatBinary(CUmodule module,
                                        byte[] fatCubin)
Load a module's data.
CUresult cuModuleLoadFatBinary ( CUmodule *  module,
const void *  fatCubin  
)

Takes a pointer fatCubin and loads the corresponding module module into the current context. The pointer represents a fat binary object, which is a collection of different cubin and/or PTX files, all representing the same device code, but compiled and optimized for different architectures.

Prior to CUDA 4.0, there was no documented API for constructing and using fat binary objects by programmers. Starting with CUDA 4.0, fat binary objects can be constructed by providing the -fatbin option to nvcc. More information can be found in the nvcc document.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_NOT_FOUND, CUDA_ERROR_OUT_OF_MEMORY, CUDA_ERROR_NO_BINARY_FOR_GPU, CUDA_ERROR_SHARED_OBJECT_SYMBOL_NOT_FOUND, CUDA_ERROR_SHARED_OBJECT_INIT_FAILED
See Also:
cuModuleGetFunction(jcuda.driver.CUfunction, jcuda.driver.CUmodule, java.lang.String), cuModuleGetGlobal(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUmodule, java.lang.String), cuModuleGetTexRef(jcuda.driver.CUtexref, jcuda.driver.CUmodule, java.lang.String), cuModuleLoad(jcuda.driver.CUmodule, java.lang.String), cuModuleLoadData(jcuda.driver.CUmodule, byte[]), cuModuleLoadDataEx(jcuda.driver.CUmodule, jcuda.Pointer, int, int[], jcuda.Pointer), cuModuleUnload(jcuda.driver.CUmodule)

cuModuleUnload

public static int cuModuleUnload(CUmodule hmod)
Unloads a module.
CUresult cuModuleUnload ( CUmodule  hmod  ) 

Unloads a module hmod from the current context.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuModuleGetFunction(jcuda.driver.CUfunction, jcuda.driver.CUmodule, java.lang.String), cuModuleGetGlobal(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUmodule, java.lang.String), cuModuleGetTexRef(jcuda.driver.CUtexref, jcuda.driver.CUmodule, java.lang.String), cuModuleLoad(jcuda.driver.CUmodule, java.lang.String), cuModuleLoadData(jcuda.driver.CUmodule, byte[]), cuModuleLoadDataEx(jcuda.driver.CUmodule, jcuda.Pointer, int, int[], jcuda.Pointer), cuModuleLoadFatBinary(jcuda.driver.CUmodule, byte[])

cuModuleGetFunction

public static int cuModuleGetFunction(CUfunction hfunc,
                                      CUmodule hmod,
                                      java.lang.String name)
Returns a function handle.
CUresult cuModuleGetFunction ( CUfunction *  hfunc,
CUmodule  hmod,
const char *  name  
)

Returns in *hfunc the handle of the function of name name located in module hmod. If no function of that name exists, cuModuleGetFunction() returns CUDA_ERROR_NOT_FOUND.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_NOT_FOUND
See Also:
cuModuleGetGlobal(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUmodule, java.lang.String), cuModuleGetTexRef(jcuda.driver.CUtexref, jcuda.driver.CUmodule, java.lang.String), cuModuleLoad(jcuda.driver.CUmodule, java.lang.String), cuModuleLoadData(jcuda.driver.CUmodule, byte[]), cuModuleLoadDataEx(jcuda.driver.CUmodule, jcuda.Pointer, int, int[], jcuda.Pointer), cuModuleLoadFatBinary(jcuda.driver.CUmodule, byte[]), cuModuleUnload(jcuda.driver.CUmodule)

cuModuleGetGlobal

public static int cuModuleGetGlobal(CUdeviceptr dptr,
                                    long[] bytes,
                                    CUmodule hmod,
                                    java.lang.String name)
Returns a global pointer from a module.
CUresult cuModuleGetGlobal ( CUdeviceptr *  dptr,
size_t *  bytes,
CUmodule  hmod,
const char *  name  
)

Returns in *dptr and *bytes the base pointer and size of the global of name name located in module hmod. If no variable of that name exists, cuModuleGetGlobal() returns CUDA_ERROR_NOT_FOUND. Both parameters dptr and bytes are optional. If one of them is NULL, it is ignored.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_NOT_FOUND
See Also:
cuModuleGetFunction(jcuda.driver.CUfunction, jcuda.driver.CUmodule, java.lang.String), cuModuleGetTexRef(jcuda.driver.CUtexref, jcuda.driver.CUmodule, java.lang.String), cuModuleLoad(jcuda.driver.CUmodule, java.lang.String), cuModuleLoadData(jcuda.driver.CUmodule, byte[]), cuModuleLoadDataEx(jcuda.driver.CUmodule, jcuda.Pointer, int, int[], jcuda.Pointer), cuModuleLoadFatBinary(jcuda.driver.CUmodule, byte[]), cuModuleUnload(jcuda.driver.CUmodule)

cuModuleGetTexRef

public static int cuModuleGetTexRef(CUtexref pTexRef,
                                    CUmodule hmod,
                                    java.lang.String name)
Returns a handle to a texture reference.
CUresult cuModuleGetTexRef ( CUtexref *  pTexRef,
CUmodule  hmod,
const char *  name  
)

Returns in *pTexRef the handle of the texture reference of name name in the module hmod. If no texture reference of that name exists, cuModuleGetTexRef() returns CUDA_ERROR_NOT_FOUND. This texture reference handle should not be destroyed, since it will be destroyed when the module is unloaded.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_NOT_FOUND
See Also:
cuModuleGetFunction(jcuda.driver.CUfunction, jcuda.driver.CUmodule, java.lang.String), cuModuleGetGlobal(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUmodule, java.lang.String), cuModuleGetSurfRef(jcuda.driver.CUsurfref, jcuda.driver.CUmodule, java.lang.String), cuModuleLoad(jcuda.driver.CUmodule, java.lang.String), cuModuleLoadData(jcuda.driver.CUmodule, byte[]), cuModuleLoadDataEx(jcuda.driver.CUmodule, jcuda.Pointer, int, int[], jcuda.Pointer), cuModuleLoadFatBinary(jcuda.driver.CUmodule, byte[]), cuModuleUnload(jcuda.driver.CUmodule)

cuModuleGetSurfRef

public static int cuModuleGetSurfRef(CUsurfref pSurfRef,
                                     CUmodule hmod,
                                     java.lang.String name)
Returns a handle to a surface reference.
CUresult cuModuleGetSurfRef ( CUsurfref *  pSurfRef,
CUmodule  hmod,
const char *  name  
)

Returns in *pSurfRef the handle of the surface reference of name name in the module hmod. If no surface reference of that name exists, cuModuleGetSurfRef() returns CUDA_ERROR_NOT_FOUND.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_NOT_FOUND
See Also:
cuModuleGetFunction(jcuda.driver.CUfunction, jcuda.driver.CUmodule, java.lang.String), cuModuleGetGlobal(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUmodule, java.lang.String), cuModuleGetTexRef(jcuda.driver.CUtexref, jcuda.driver.CUmodule, java.lang.String), cuModuleLoad(jcuda.driver.CUmodule, java.lang.String), cuModuleLoadData(jcuda.driver.CUmodule, byte[]), cuModuleLoadDataEx(jcuda.driver.CUmodule, jcuda.Pointer, int, int[], jcuda.Pointer), cuModuleLoadFatBinary(jcuda.driver.CUmodule, byte[]), cuModuleUnload(jcuda.driver.CUmodule)

cuMemGetInfo

public static int cuMemGetInfo(long[] free,
                               long[] total)
Gets free and total memory.
CUresult cuMemGetInfo ( size_t *  free,
size_t *  total  
)

Returns in *free and *total respectively, the free and total amount of memory available for allocation by the CUDA context, in bytes.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemHostAlloc

public static int cuMemHostAlloc(Pointer pp,
                                 long bytes,
                                 int Flags)
Allocates page-locked host memory.
CUresult cuMemHostAlloc ( void **  pp,
size_t  bytesize,
unsigned int  Flags  
)

Allocates bytesize bytes of host memory that is page-locked and accessible to the device. The driver tracks the virtual memory ranges allocated with this function and automatically accelerates calls to functions such as cuMemcpyHtoD(). Since the memory can be accessed directly by the device, it can be read or written with much higher bandwidth than pageable memory obtained with functions such as malloc(). Allocating excessive amounts of pinned memory may degrade system performance, since it reduces the amount of memory available to the system for paging. As a result, this function is best used sparingly to allocate staging areas for data exchange between host and device.

The Flags parameter enables different options to be specified that affect the allocation, as follows.

  • CU_MEMHOSTALLOC_PORTABLE: The memory returned by this call will be considered as pinned memory by all CUDA contexts, not just the one that performed the allocation.

  • CU_MEMHOSTALLOC_DEVICEMAP: Maps the allocation into the CUDA address space. The device pointer to the memory may be obtained by calling cuMemHostGetDevicePointer(). This feature is available only on GPUs with compute capability greater than or equal to 1.1.

  • CU_MEMHOSTALLOC_WRITECOMBINED: Allocates the memory as write-combined (WC). WC memory can be transferred across the PCI Express bus more quickly on some system configurations, but cannot be read efficiently by most CPUs. WC memory is a good option for buffers that will be written by the CPU and read by the GPU via mapped pinned memory or host->device transfers.

All of these flags are orthogonal to one another: a developer may allocate memory that is portable, mapped and/or write-combined with no restrictions.

The CUDA context must have been created with the CU_CTX_MAP_HOST flag in order for the CU_MEMHOSTALLOC_MAPPED flag to have any effect.

The CU_MEMHOSTALLOC_MAPPED flag may be specified on CUDA contexts for devices that do not support mapped pinned memory. The failure is deferred to cuMemHostGetDevicePointer() because the memory may be mapped into other CUDA contexts via the CU_MEMHOSTALLOC_PORTABLE flag.

The memory allocated by this function must be freed with cuMemFreeHost().

Note all host memory allocated using cuMemHostAlloc() will automatically be immediately accessible to all contexts on all devices which support unified addressing (as may be queried using CU_DEVICE_ATTRIBUTE_UNIFIED_ADDRESSING). Unless the flag CU_MEMHOSTALLOC_WRITECOMBINED is specified, the device pointer that may be used to access this host memory from those contexts is always equal to the returned host pointer *pp. If the flag CU_MEMHOSTALLOC_WRITECOMBINED is specified, then the function cuMemHostGetDevicePointer() must be used to query the device pointer, even if the context supports unified addressing. See Unified Addressing for additional details.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemHostGetDevicePointer

public static int cuMemHostGetDevicePointer(CUdeviceptr ret,
                                            Pointer p,
                                            int Flags)
Passes back device pointer of mapped pinned memory.
CUresult cuMemHostGetDevicePointer ( CUdeviceptr *  pdptr,
void *  p,
unsigned int  Flags  
)

Passes back the device pointer pdptr corresponding to the mapped, pinned host buffer p allocated by cuMemHostAlloc.

cuMemHostGetDevicePointer() will fail if the CU_MEMALLOCHOST_DEVICEMAP flag was not specified at the time the memory was allocated, or if the function is called on a GPU that does not support mapped pinned memory.

Flags provides for future releases. For now, it must be set to 0.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemHostGetFlags

public static int cuMemHostGetFlags(int[] pFlags,
                                    Pointer p)
Passes back flags that were used for a pinned allocation.
CUresult cuMemHostGetFlags ( unsigned int *  pFlags,
void *  p  
)

Passes back the flags pFlags that were specified when allocating the pinned host buffer p allocated by cuMemHostAlloc.

cuMemHostGetFlags() will fail if the pointer does not reside in an allocation performed by cuMemAllocHost() or cuMemHostAlloc().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuMemAllocHost(jcuda.Pointer, long), cuMemHostAlloc(jcuda.Pointer, long, int)

cuDeviceGetByPCIBusId

public static int cuDeviceGetByPCIBusId(CUdevice dev,
                                        java.lang.String pciBusId)
Returns a handle to a compute device.
CUresult cuDeviceGetByPCIBusId ( CUdevice *  dev,
char *  pciBusId  
)

Returns in *device a device handle given a PCI bus ID string.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE
See Also:
cuDeviceGet(jcuda.driver.CUdevice, int), cuDeviceGetAttribute(int[], int, jcuda.driver.CUdevice), cuDeviceGetPCIBusId(java.lang.String[], int, jcuda.driver.CUdevice)

cuDeviceGetPCIBusId

public static int cuDeviceGetPCIBusId(java.lang.String[] pciBusId,
                                      int len,
                                      CUdevice dev)
Returns a PCI Bus Id string for the device.
CUresult cuDeviceGetPCIBusId ( char *  pciBusId,
int  len,
CUdevice  dev  
)

Returns an ASCII string identifying the device dev in the NULL-terminated string pointed to by pciBusId. len specifies the maximum length of the string that may be returned.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE
See Also:
cuDeviceGet(jcuda.driver.CUdevice, int), cuDeviceGetAttribute(int[], int, jcuda.driver.CUdevice), cuDeviceGetByPCIBusId(jcuda.driver.CUdevice, java.lang.String)

cuIpcGetEventHandle

public static int cuIpcGetEventHandle(CUipcEventHandle pHandle,
                                      CUevent event)
Gets an interprocess handle for a previously allocated event.
CUresult cuIpcGetEventHandle ( CUipcEventHandle *  pHandle,
CUevent  event  
)

Takes as input a previously allocated event. This event must have been created with the CU_EVENT_INTERPROCESS and CU_EVENT_DISABLE_TIMING flags set. This opaque handle may be copied into other processes and opened with cuIpcOpenEventHandle to allow efficient hardware synchronization between GPU work in different processes.

After the event has been been opened in the importing process, cuEventRecord, cuEventSynchronize, cuStreamWaitEvent and cuEventQuery may be used in either process. Performing operations on the imported event after the exported event has been freed with cuEventDestroy will result in undefined behavior.

IPC functionality is restricted to devices with support for unified addressing on Linux operating systems.

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_OUT_OF_MEMORY, CUDA_ERROR_MAP_FAILED
See Also:
cuEventCreate(jcuda.driver.CUevent, int), cuEventDestroy(jcuda.driver.CUevent), cuEventSynchronize(jcuda.driver.CUevent), cuEventQuery(jcuda.driver.CUevent), cuStreamWaitEvent(jcuda.driver.CUstream, jcuda.driver.CUevent, int), cuIpcOpenEventHandle(jcuda.driver.CUevent, jcuda.driver.CUipcEventHandle), cuIpcGetMemHandle(jcuda.driver.CUipcMemHandle, jcuda.driver.CUdeviceptr), cuIpcOpenMemHandle(jcuda.driver.CUdeviceptr, jcuda.driver.CUipcMemHandle, int), cuIpcCloseMemHandle(jcuda.driver.CUdeviceptr)

cuIpcOpenEventHandle

public static int cuIpcOpenEventHandle(CUevent phEvent,
                                       CUipcEventHandle handle)
Opens an interprocess event handle for use in the current process.
CUresult cuIpcOpenEventHandle ( CUevent *  phEvent,
CUipcEventHandle  handle  
)

Opens an interprocess event handle exported from another process with cuIpcGetEventHandle. This function returns a CUevent that behaves like a locally created event with the CU_EVENT_DISABLE_TIMING flag specified. This event must be freed with cuEventDestroy.

Performing operations on the imported event after the exported event has been freed with cuEventDestroy will result in undefined behavior.

IPC functionality is restricted to devices with support for unified addressing on Linux operating systems.

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_MAP_FAILED, CUDA_ERROR_INVALID_HANDLE
See Also:
cuEventCreate(jcuda.driver.CUevent, int), cuEventDestroy(jcuda.driver.CUevent), cuEventSynchronize(jcuda.driver.CUevent), cuEventQuery(jcuda.driver.CUevent), cuStreamWaitEvent(jcuda.driver.CUstream, jcuda.driver.CUevent, int), cuIpcGetEventHandle(jcuda.driver.CUipcEventHandle, jcuda.driver.CUevent), cuIpcGetMemHandle(jcuda.driver.CUipcMemHandle, jcuda.driver.CUdeviceptr), cuIpcOpenMemHandle(jcuda.driver.CUdeviceptr, jcuda.driver.CUipcMemHandle, int), cuIpcCloseMemHandle(jcuda.driver.CUdeviceptr)

cuIpcGetMemHandle

public static int cuIpcGetMemHandle(CUipcMemHandle pHandle,
                                    CUdeviceptr dptr)
Gets an interprocess memory handle for an existing device memory allocation.
CUresult cuIpcGetMemHandle ( CUipcMemHandle *  pHandle,
CUdeviceptr  dptr  
)

/brief Gets an interprocess memory handle for an existing device memory allocation

Takes a pointer to the base of an existing device memory allocation created with cuMemAlloc and exports it for use in another process. This is a lightweight operation and may be called multiple times on an allocation without adverse effects.

If a region of memory is freed with cuMemFree and a subsequent call to cuMemAlloc returns memory with the same device address, cuIpcGetMemHandle will return a unique handle for the new memory.

IPC functionality is restricted to devices with support for unified addressing on Linux operating systems.

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_OUT_OF_MEMORY, CUDA_ERROR_MAP_FAILED,
See Also:
cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemFree(jcuda.driver.CUdeviceptr), cuIpcGetEventHandle(jcuda.driver.CUipcEventHandle, jcuda.driver.CUevent), cuIpcOpenEventHandle(jcuda.driver.CUevent, jcuda.driver.CUipcEventHandle), cuIpcOpenMemHandle(jcuda.driver.CUdeviceptr, jcuda.driver.CUipcMemHandle, int), cuIpcCloseMemHandle(jcuda.driver.CUdeviceptr)

cuIpcOpenMemHandle

public static int cuIpcOpenMemHandle(CUdeviceptr pdptr,
                                     CUipcMemHandle handle,
                                     int Flags)
Opens an interprocess memory handle exported from another process and returns a device pointer usable in the local process.
CUresult cuIpcOpenMemHandle ( CUdeviceptr *  pdptr,
CUipcMemHandle  handle  
)

/brief Opens an interprocess memory handle exported from another process and returns a device pointer usable in the local process.

Maps memory exported from another process with cuIpcGetMemHandle into the current device address space. For contexts on different devices cuIpcOpenMemHandle will attempt to enable peer access between the devices as if the user called cuCtxEnablePeerAccess. Calling cuDeviceCanAccessPeer can determine if this mapping is possible.

Calling cuMemFree on an exported memory region before calling cuIpcCloseMemHandle in the importing context will result in undefined behavior.

Memory returned from cuIpcOpenMemHandle must be freed with cuIpcCloseMemHandle.

IPC functionality is restricted to devices with support for unified addressing on Linux operating systems.

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_MAP_FAILED, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_TOO_MANY_PEERS
See Also:
cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemFree(jcuda.driver.CUdeviceptr), cuIpcGetEventHandle(jcuda.driver.CUipcEventHandle, jcuda.driver.CUevent), cuIpcOpenEventHandle(jcuda.driver.CUevent, jcuda.driver.CUipcEventHandle), cuIpcGetMemHandle(jcuda.driver.CUipcMemHandle, jcuda.driver.CUdeviceptr), cuIpcCloseMemHandle(jcuda.driver.CUdeviceptr), cuCtxEnablePeerAccess(jcuda.driver.CUcontext, int), cuDeviceCanAccessPeer(int[], jcuda.driver.CUdevice, jcuda.driver.CUdevice)

cuIpcCloseMemHandle

public static int cuIpcCloseMemHandle(CUdeviceptr dptr)
Close memory mapped with ::cuIpcOpenMemHandle.
CUresult cuIpcCloseMemHandle ( CUdeviceptr  dptr  ) 

/brief Close memory mapped with cuIpcOpenMemHandle

Unmaps memory returnd by cuIpcOpenMemHandle. The original allocation in the exporting process as well as imported mappings in other processes will be unaffected.

Any resources used to enable peer access will be freed if this is the last mapping using them.

IPC functionality is restricted to devices with support for unified addressing on Linux operating systems.

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_MAP_FAILED, CUDA_ERROR_INVALID_HANDLE,
See Also:
cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemFree(jcuda.driver.CUdeviceptr), cuIpcGetEventHandle(jcuda.driver.CUipcEventHandle, jcuda.driver.CUevent), cuIpcOpenEventHandle(jcuda.driver.CUevent, jcuda.driver.CUipcEventHandle), cuIpcGetMemHandle(jcuda.driver.CUipcMemHandle, jcuda.driver.CUdeviceptr), cuIpcOpenMemHandle(jcuda.driver.CUdeviceptr, jcuda.driver.CUipcMemHandle, int)

cuMemHostRegister

public static int cuMemHostRegister(Pointer p,
                                    long bytesize,
                                    int Flags)
Registers an existing host memory range for use by CUDA.
CUresult cuMemHostRegister ( void *  p,
size_t  bytesize,
unsigned int  Flags  
)

Page-locks the memory range specified by p and bytesize and maps it for the device(s) as specified by Flags. This memory range also is added to the same tracking mechanism as cuMemHostAlloc to automatically accelerate calls to functions such as cuMemcpyHtoD(). Since the memory can be accessed directly by the device, it can be read or written with much higher bandwidth than pageable memory that has not been registered. Page-locking excessive amounts of memory may degrade system performance, since it reduces the amount of memory available to the system for paging. As a result, this function is best used sparingly to register staging areas for data exchange between host and device.

This function has limited support on Mac OS X. OS 10.7 or higher is required.

The Flags parameter enables different options to be specified that affect the allocation, as follows.

  • CU_MEMHOSTREGISTER_PORTABLE: The memory returned by this call will be considered as pinned memory by all CUDA contexts, not just the one that performed the allocation.

  • CU_MEMHOSTREGISTER_DEVICEMAP: Maps the allocation into the CUDA address space. The device pointer to the memory may be obtained by calling cuMemHostGetDevicePointer(). This feature is available only on GPUs with compute capability greater than or equal to 1.1.

All of these flags are orthogonal to one another: a developer may page-lock memory that is portable or mapped with no restrictions.

The CUDA context must have been created with the CU_CTX_MAP_HOST flag in order for the CU_MEMHOSTREGISTER_DEVICEMAP flag to have any effect.

The CU_MEMHOSTREGISTER_DEVICEMAP flag may be specified on CUDA contexts for devices that do not support mapped pinned memory. The failure is deferred to cuMemHostGetDevicePointer() because the memory may be mapped into other CUDA contexts via the CU_MEMHOSTREGISTER_PORTABLE flag.

The memory page-locked by this function must be unregistered with cuMemHostUnregister().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY
See Also:
cuMemHostUnregister(jcuda.Pointer), cuMemHostGetFlags(int[], jcuda.Pointer), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int)

cuMemHostUnregister

public static int cuMemHostUnregister(Pointer p)
Unregisters a memory range that was registered with cuMemHostRegister().
CUresult cuMemHostUnregister ( void *  p  ) 

Unmaps the memory range whose base address is specified by p, and makes it pageable again.

The base address must be the same one specified to cuMemHostRegister().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY
See Also:
cuMemHostRegister(jcuda.Pointer, long, int)

cuMemcpy

public static int cuMemcpy(CUdeviceptr dst,
                           CUdeviceptr src,
                           long ByteCount)
Copies memory.
CUresult cuMemcpy ( CUdeviceptr  dst,
CUdeviceptr  src,
size_t  ByteCount  
)

Copies data between two pointers. dst and src are base pointers of the destination and source, respectively. ByteCount specifies the number of bytes to copy. Note that this function infers the type of the transfer (host to host, host to device, device to device, or device to host) from the pointer values. This function is only allowed in contexts which support unified addressing. Note that this function is synchronous.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpyPeer

public static int cuMemcpyPeer(CUdeviceptr dstDevice,
                               CUcontext dstContext,
                               CUdeviceptr srcDevice,
                               CUcontext srcContext,
                               long ByteCount)
Copies device memory between two contexts.
CUresult cuMemcpyPeer ( CUdeviceptr  dstDevice,
CUcontext  dstContext,
CUdeviceptr  srcDevice,
CUcontext  srcContext,
size_t  ByteCount  
)

Copies from device memory in one context to device memory in another context. dstDevice is the base device pointer of the destination memory and dstContext is the destination context. srcDevice is the base device pointer of the source memory and srcContext is the source pointer. ByteCount specifies the number of bytes to copy.

Note that this function is asynchronous with respect to the host, but serialized with respect all pending and future asynchronous work in to the current context, srcContext, and dstContext (use cuMemcpyPeerAsync to avoid this synchronization).

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpy3DPeer(jcuda.driver.CUDA_MEMCPY3D_PEER), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyPeerAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUcontext, jcuda.driver.CUdeviceptr, jcuda.driver.CUcontext, long, jcuda.driver.CUstream), cuMemcpy3DPeerAsync(jcuda.driver.CUDA_MEMCPY3D_PEER, jcuda.driver.CUstream)

cuMemAlloc

public static int cuMemAlloc(CUdeviceptr dptr,
                             long bytesize)
Allocates device memory.
CUresult cuMemAlloc ( CUdeviceptr *  dptr,
size_t  bytesize  
)

Allocates bytesize bytes of linear memory on the device and returns in *dptr a pointer to the allocated memory. The allocated memory is suitably aligned for any kind of variable. The memory is not cleared. If bytesize is 0, cuMemAlloc() returns CUDA_ERROR_INVALID_VALUE.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemAllocPitch

public static int cuMemAllocPitch(CUdeviceptr dptr,
                                  long[] pPitch,
                                  long WidthInBytes,
                                  long Height,
                                  int ElementSizeBytes)
Allocates pitched device memory.
CUresult cuMemAllocPitch ( CUdeviceptr *  dptr,
size_t *  pPitch,
size_t  WidthInBytes,
size_t  Height,
unsigned int  ElementSizeBytes  
)

Allocates at least WidthInBytes * Height bytes of linear memory on the device and returns in *dptr a pointer to the allocated memory. The function may pad the allocation to ensure that corresponding pointers in any given row will continue to meet the alignment requirements for coalescing as the address is updated from row to row. ElementSizeBytes specifies the size of the largest reads and writes that will be performed on the memory range. ElementSizeBytes may be 4, 8 or 16 (since coalesced memory transactions are not possible on other data sizes). If ElementSizeBytes is smaller than the actual read/write size of a kernel, the kernel will run correctly, but possibly at reduced speed. The pitch returned in *pPitch by cuMemAllocPitch() is the width in bytes of the allocation. The intended usage of pitch is as a separate parameter of the allocation, used to compute addresses within the 2D array. Given the row and column of an array element of type T, the address is computed as:

   T* pElement = (T*)((char*)BaseAddress + Row * Pitch)
 + Column;
 

The pitch returned by cuMemAllocPitch() is guaranteed to work with cuMemcpy2D() under all circumstances. For allocations of 2D arrays, it is recommended that programmers consider performing pitch allocations using cuMemAllocPitch(). Due to alignment restrictions in the hardware, this is especially true if the application will be performing 2D memory copies between different regions of device memory (whether linear memory or CUDA arrays).

The byte alignment of the pitch returned by cuMemAllocPitch() is guaranteed to match or exceed the alignment requirement for texture binding with cuTexRefSetAddress2D().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemFree

public static int cuMemFree(CUdeviceptr dptr)
Frees device memory.
CUresult cuMemFree ( CUdeviceptr  dptr  ) 

Frees the memory space pointed to by dptr, which must have been returned by a previous call to cuMemAlloc() or cuMemAllocPitch().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemGetAddressRange

public static int cuMemGetAddressRange(CUdeviceptr pbase,
                                       long[] psize,
                                       CUdeviceptr dptr)
Get information on memory allocations.
CUresult cuMemGetAddressRange ( CUdeviceptr *  pbase,
size_t *  psize,
CUdeviceptr  dptr  
)

Returns the base address in *pbase and size in *psize of the allocation by cuMemAlloc() or cuMemAllocPitch() that contains the input pointer dptr. Both parameters pbase and psize are optional. If one of them is NULL, it is ignored.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemAllocHost

public static int cuMemAllocHost(Pointer pointer,
                                 long bytesize)
Allocates page-locked host memory.
CUresult cuMemAllocHost ( void **  pp,
size_t  bytesize  
)

Allocates bytesize bytes of host memory that is page-locked and accessible to the device. The driver tracks the virtual memory ranges allocated with this function and automatically accelerates calls to functions such as cuMemcpy(). Since the memory can be accessed directly by the device, it can be read or written with much higher bandwidth than pageable memory obtained with functions such as malloc(). Allocating excessive amounts of memory with cuMemAllocHost() may degrade system performance, since it reduces the amount of memory available to the system for paging. As a result, this function is best used sparingly to allocate staging areas for data exchange between host and device.

Note all host memory allocated using cuMemHostAlloc() will automatically be immediately accessible to all contexts on all devices which support unified addressing (as may be queried using CU_DEVICE_ATTRIBUTE_UNIFIED_ADDRESSING). The device pointer that may be used to access this host memory from those contexts is always equal to the returned host pointer *pp. See Unified Addressing for additional details.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemFreeHost

public static int cuMemFreeHost(Pointer p)
Frees page-locked host memory.
CUresult cuMemFreeHost ( void *  p  ) 

Frees the memory space pointed to by p, which must have been returned by a previous call to cuMemAllocHost().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpyHtoD

public static int cuMemcpyHtoD(CUdeviceptr dstDevice,
                               Pointer srcHost,
                               long ByteCount)
Copies memory from Host to Device.
CUresult cuMemcpyHtoD ( CUdeviceptr  dstDevice,
const void *  srcHost,
size_t  ByteCount  
)

Copies from host memory to device memory. dstDevice and srcHost are the base addresses of the destination and source, respectively. ByteCount specifies the number of bytes to copy. Note that this function is synchronous.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpyDtoH

public static int cuMemcpyDtoH(Pointer dstHost,
                               CUdeviceptr srcDevice,
                               long ByteCount)
Copies memory from Device to Host.
CUresult cuMemcpyDtoH ( void *  dstHost,
CUdeviceptr  srcDevice,
size_t  ByteCount  
)

Copies from device to host memory. dstHost and srcDevice specify the base pointers of the destination and source, respectively. ByteCount specifies the number of bytes to copy. Note that this function is synchronous.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpyDtoD

public static int cuMemcpyDtoD(CUdeviceptr dstDevice,
                               CUdeviceptr srcDevice,
                               long ByteCount)
Copies memory from Device to Device.
CUresult cuMemcpyDtoD ( CUdeviceptr  dstDevice,
CUdeviceptr  srcDevice,
size_t  ByteCount  
)

Copies from device memory to device memory. dstDevice and srcDevice are the base pointers of the destination and source, respectively. ByteCount specifies the number of bytes to copy. Note that this function is asynchronous.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpyDtoA

public static int cuMemcpyDtoA(CUarray dstArray,
                               long dstIndex,
                               CUdeviceptr srcDevice,
                               long ByteCount)
Copies memory from Device to Array.
CUresult cuMemcpyDtoA ( CUarray  dstArray,
size_t  dstOffset,
CUdeviceptr  srcDevice,
size_t  ByteCount  
)

Copies from device memory to a 1D CUDA array. dstArray and dstOffset specify the CUDA array handle and starting index of the destination data. srcDevice specifies the base pointer of the source. ByteCount specifies the number of bytes to copy.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpyAtoD

public static int cuMemcpyAtoD(CUdeviceptr dstDevice,
                               CUarray hSrc,
                               long SrcIndex,
                               long ByteCount)
Copies memory from Array to Device.
CUresult cuMemcpyAtoD ( CUdeviceptr  dstDevice,
CUarray  srcArray,
size_t  srcOffset,
size_t  ByteCount  
)

Copies from one 1D CUDA array to device memory. dstDevice specifies the base pointer of the destination and must be naturally aligned with the CUDA array elements. srcArray and srcOffset specify the CUDA array handle and the offset in bytes into the array where the copy is to begin. ByteCount specifies the number of bytes to copy and must be evenly divisible by the array element size.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpyHtoA

public static int cuMemcpyHtoA(CUarray dstArray,
                               long dstIndex,
                               Pointer pSrc,
                               long ByteCount)
Copies memory from Host to Array.
CUresult cuMemcpyHtoA ( CUarray  dstArray,
size_t  dstOffset,
const void *  srcHost,
size_t  ByteCount  
)

Copies from host memory to a 1D CUDA array. dstArray and dstOffset specify the CUDA array handle and starting offset in bytes of the destination data. pSrc specifies the base address of the source. ByteCount specifies the number of bytes to copy.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpyAtoH

public static int cuMemcpyAtoH(Pointer dstHost,
                               CUarray srcArray,
                               long srcIndex,
                               long ByteCount)
Copies memory from Array to Host.
CUresult cuMemcpyAtoH ( void *  dstHost,
CUarray  srcArray,
size_t  srcOffset,
size_t  ByteCount  
)

Copies from one 1D CUDA array to host memory. dstHost specifies the base pointer of the destination. srcArray and srcOffset specify the CUDA array handle and starting offset in bytes of the source data. ByteCount specifies the number of bytes to copy.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpyAtoA

public static int cuMemcpyAtoA(CUarray dstArray,
                               long dstIndex,
                               CUarray srcArray,
                               long srcIndex,
                               long ByteCount)
Copies memory from Array to Array.
CUresult cuMemcpyAtoA ( CUarray  dstArray,
size_t  dstOffset,
CUarray  srcArray,
size_t  srcOffset,
size_t  ByteCount  
)

Copies from one 1D CUDA array to another. dstArray and srcArray specify the handles of the destination and source CUDA arrays for the copy, respectively. dstOffset and srcOffset specify the destination and source offsets in bytes into the CUDA arrays. ByteCount is the number of bytes to be copied. The size of the elements in the CUDA arrays need not be the same format, but the elements must be the same size; and count must be evenly divisible by that size.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpy2D

public static int cuMemcpy2D(CUDA_MEMCPY2D pCopy)
Copies memory for 2D arrays.
CUresult cuMemcpy2D ( const CUDA_MEMCPY2D *  pCopy  ) 

Perform a 2D memory copy according to the parameters specified in pCopy. The CUDA_MEMCPY2D structure is defined as:

   typedef struct CUDA_MEMCPY2D_st
 {
       unsigned int srcXInBytes, srcY;
       CUmemorytype srcMemoryType;
           const void *srcHost;
           CUdeviceptr srcDevice;
           CUarray srcArray;
           unsigned int srcPitch;

       unsigned int dstXInBytes, dstY;
       CUmemorytype dstMemoryType;
           void *dstHost;
           CUdeviceptr dstDevice;
           CUarray dstArray;
           unsigned int dstPitch;

       unsigned int WidthInBytes;
       unsigned int Height;
    } CUDA_MEMCPY2D;
 
where:
  • srcMemoryType and dstMemoryType specify the type of memory of the source and destination, respectively; CUmemorytype_enum is defined as:

   typedef enum CUmemorytype_enum
 {
       CU_MEMORYTYPE_HOST = 0x01,
       CU_MEMORYTYPE_DEVICE = 0x02,
       CU_MEMORYTYPE_ARRAY = 0x03,
       CU_MEMORYTYPE_UNIFIED = 0x04
    } CUmemorytype;
 

If srcMemoryType is CU_MEMORYTYPE_UNIFIED, srcDevice and srcPitch specify the (unified virtual address space) base address of the source data and the bytes per row to apply. srcArray is ignored. This value may be used only if unified addressing is supported in the calling context.
If srcMemoryType is CU_MEMORYTYPE_HOST, srcHost and srcPitch specify the (host) base address of the source data and the bytes per row to apply. srcArray is ignored.
If srcMemoryType is CU_MEMORYTYPE_DEVICE, srcDevice and srcPitch specify the (device) base address of the source data and the bytes per row to apply. srcArray is ignored.
If srcMemoryType is CU_MEMORYTYPE_ARRAY, srcArray specifies the handle of the source data. srcHost, srcDevice and srcPitch are ignored.
If dstMemoryType is CU_MEMORYTYPE_HOST, dstHost and dstPitch specify the (host) base address of the destination data and the bytes per row to apply. dstArray is ignored.
If dstMemoryType is CU_MEMORYTYPE_UNIFIED, dstDevice and dstPitch specify the (unified virtual address space) base address of the source data and the bytes per row to apply. dstArray is ignored. This value may be used only if unified addressing is supported in the calling context.
If dstMemoryType is CU_MEMORYTYPE_DEVICE, dstDevice and dstPitch specify the (device) base address of the destination data and the bytes per row to apply. dstArray is ignored.
If dstMemoryType is CU_MEMORYTYPE_ARRAY, dstArray specifies the handle of the destination data. dstHost, dstDevice and dstPitch are ignored.
  • srcXInBytes and srcY specify the base address of the source data for the copy.

For host pointers, the starting address is
  void* Start = (void*)((char*)srcHost+srcY*srcPitch +
 srcXInBytes);
 
For device pointers, the starting address is
  CUdeviceptr Start =
 srcDevice+srcY*srcPitch+srcXInBytes;
 
For CUDA arrays, srcXInBytes must be evenly divisible by the array element size.
  • dstXInBytes and dstY specify the base address of the destination data for the copy.

For host pointers, the base address is
  void* dstStart = (void*)((char*)dstHost+dstY*dstPitch +
 dstXInBytes);
 
For device pointers, the starting address is
  CUdeviceptr dstStart =
 dstDevice+dstY*dstPitch+dstXInBytes;
 
For CUDA arrays, dstXInBytes must be evenly divisible by the array element size.
  • WidthInBytes and Height specify the width (in bytes) and height of the 2D copy being performed.
  • If specified, srcPitch must be greater than or equal to WidthInBytes + srcXInBytes, and dstPitch must be greater than or equal to WidthInBytes + dstXInBytes.

cuMemcpy2D() returns an error if any pitch is greater than the maximum allowed (CU_DEVICE_ATTRIBUTE_MAX_PITCH). cuMemAllocPitch() passes back pitches that always work with cuMemcpy2D(). On intra-device memory copies (device to device, CUDA array to device, CUDA array to CUDA array), cuMemcpy2D() may fail for pitches not computed by cuMemAllocPitch(). cuMemcpy2DUnaligned() does not have this restriction, but may run significantly slower in the cases where cuMemcpy2D() would have returned an error code.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpy2DUnaligned

public static int cuMemcpy2DUnaligned(CUDA_MEMCPY2D pCopy)
Copies memory for 2D arrays.
CUresult cuMemcpy2DUnaligned ( const CUDA_MEMCPY2D *  pCopy  ) 

Perform a 2D memory copy according to the parameters specified in pCopy. The CUDA_MEMCPY2D structure is defined as:

   typedef struct CUDA_MEMCPY2D_st
 {
       unsigned int srcXInBytes, srcY;
       CUmemorytype srcMemoryType;
       const void *srcHost;
       CUdeviceptr srcDevice;
       CUarray srcArray;
       unsigned int srcPitch;
       unsigned int dstXInBytes, dstY;
       CUmemorytype dstMemoryType;
       void *dstHost;
       CUdeviceptr dstDevice;
       CUarray dstArray;
       unsigned int dstPitch;
       unsigned int WidthInBytes;
       unsigned int Height;
    } CUDA_MEMCPY2D;
 
where:
  • srcMemoryType and dstMemoryType specify the type of memory of the source and destination, respectively; CUmemorytype_enum is defined as:

   typedef enum CUmemorytype_enum
 {
       CU_MEMORYTYPE_HOST = 0x01,
       CU_MEMORYTYPE_DEVICE = 0x02,
       CU_MEMORYTYPE_ARRAY = 0x03,
       CU_MEMORYTYPE_UNIFIED = 0x04
    } CUmemorytype;
 

If srcMemoryType is CU_MEMORYTYPE_UNIFIED, srcDevice and srcPitch specify the (unified virtual address space) base address of the source data and the bytes per row to apply. srcArray is ignored. This value may be used only if unified addressing is supported in the calling context.
If srcMemoryType is CU_MEMORYTYPE_HOST, srcHost and srcPitch specify the (host) base address of the source data and the bytes per row to apply. srcArray is ignored.
If srcMemoryType is CU_MEMORYTYPE_DEVICE, srcDevice and srcPitch specify the (device) base address of the source data and the bytes per row to apply. srcArray is ignored.
If srcMemoryType is CU_MEMORYTYPE_ARRAY, srcArray specifies the handle of the source data. srcHost, srcDevice and srcPitch are ignored.
If dstMemoryType is CU_MEMORYTYPE_UNIFIED, dstDevice and dstPitch specify the (unified virtual address space) base address of the source data and the bytes per row to apply. dstArray is ignored. This value may be used only if unified addressing is supported in the calling context.
If dstMemoryType is CU_MEMORYTYPE_HOST, dstHost and dstPitch specify the (host) base address of the destination data and the bytes per row to apply. dstArray is ignored.
If dstMemoryType is CU_MEMORYTYPE_DEVICE, dstDevice and dstPitch specify the (device) base address of the destination data and the bytes per row to apply. dstArray is ignored.
If dstMemoryType is CU_MEMORYTYPE_ARRAY, dstArray specifies the handle of the destination data. dstHost, dstDevice and dstPitch are ignored.
  • srcXInBytes and srcY specify the base address of the source data for the copy.

For host pointers, the starting address is
  void* Start = (void*)((char*)srcHost+srcY*srcPitch +
 srcXInBytes);
 
For device pointers, the starting address is
  CUdeviceptr Start =
 srcDevice+srcY*srcPitch+srcXInBytes;
 
For CUDA arrays, srcXInBytes must be evenly divisible by the array element size.
  • dstXInBytes and dstY specify the base address of the destination data for the copy.

For host pointers, the base address is
  void* dstStart = (void*)((char*)dstHost+dstY*dstPitch +
 dstXInBytes);
 
For device pointers, the starting address is
  CUdeviceptr dstStart =
 dstDevice+dstY*dstPitch+dstXInBytes;
 
For CUDA arrays, dstXInBytes must be evenly divisible by the array element size.
  • WidthInBytes and Height specify the width (in bytes) and height of the 2D copy being performed.
  • If specified, srcPitch must be greater than or equal to WidthInBytes + srcXInBytes, and dstPitch must be greater than or equal to WidthInBytes + dstXInBytes.

cuMemcpy2D() returns an error if any pitch is greater than the maximum allowed (CU_DEVICE_ATTRIBUTE_MAX_PITCH). cuMemAllocPitch() passes back pitches that always work with cuMemcpy2D(). On intra-device memory copies (device to device, CUDA array to device, CUDA array to CUDA array), cuMemcpy2D() may fail for pitches not computed by cuMemAllocPitch(). cuMemcpy2DUnaligned() does not have this restriction, but may run significantly slower in the cases where cuMemcpy2D() would have returned an error code.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpy3D

public static int cuMemcpy3D(CUDA_MEMCPY3D pCopy)
Copies memory for 3D arrays.
CUresult cuMemcpy3D ( const CUDA_MEMCPY3D *  pCopy  ) 

Perform a 3D memory copy according to the parameters specified in pCopy. The CUDA_MEMCPY3D structure is defined as:

        typedef struct
 CUDA_MEMCPY3D_st {

             unsigned int srcXInBytes, srcY,
 srcZ;
             unsigned int srcLOD;
             CUmemorytype srcMemoryType;
                 const void *srcHost;
                 CUdeviceptr srcDevice;
                 CUarray srcArray;
                 unsigned int srcPitch;
 // ignored when src is array
                 unsigned int srcHeight;
 // ignored when src is array; may be 0 if Depth==1

             unsigned int dstXInBytes, dstY,
 dstZ;
             unsigned int dstLOD;
             CUmemorytype dstMemoryType;
                 void *dstHost;
                 CUdeviceptr dstDevice;
                 CUarray dstArray;
                 unsigned int dstPitch;
 // ignored when dst is array
                 unsigned int dstHeight;
 // ignored when dst is array; may be 0 if Depth==1

             unsigned int WidthInBytes;
             unsigned int Height;
             unsigned int Depth;
         } CUDA_MEMCPY3D;
 
where:
  • srcMemoryType and dstMemoryType specify the type of memory of the source and destination, respectively; CUmemorytype_enum is defined as:

   typedef enum CUmemorytype_enum
 {
       CU_MEMORYTYPE_HOST = 0x01,
       CU_MEMORYTYPE_DEVICE = 0x02,
       CU_MEMORYTYPE_ARRAY = 0x03,
       CU_MEMORYTYPE_UNIFIED = 0x04
    } CUmemorytype;
 

If srcMemoryType is CU_MEMORYTYPE_UNIFIED, srcDevice and srcPitch specify the (unified virtual address space) base address of the source data and the bytes per row to apply. srcArray is ignored. This value may be used only if unified addressing is supported in the calling context.
If srcMemoryType is CU_MEMORYTYPE_HOST, srcHost, srcPitch and srcHeight specify the (host) base address of the source data, the bytes per row, and the height of each 2D slice of the 3D array. srcArray is ignored.
If srcMemoryType is CU_MEMORYTYPE_DEVICE, srcDevice, srcPitch and srcHeight specify the (device) base address of the source data, the bytes per row, and the height of each 2D slice of the 3D array. srcArray is ignored.
If srcMemoryType is CU_MEMORYTYPE_ARRAY, srcArray specifies the handle of the source data. srcHost, srcDevice, srcPitch and srcHeight are ignored.
If dstMemoryType is CU_MEMORYTYPE_UNIFIED, dstDevice and dstPitch specify the (unified virtual address space) base address of the source data and the bytes per row to apply. dstArray is ignored. This value may be used only if unified addressing is supported in the calling context.
If dstMemoryType is CU_MEMORYTYPE_HOST, dstHost and dstPitch specify the (host) base address of the destination data, the bytes per row, and the height of each 2D slice of the 3D array. dstArray is ignored.
If dstMemoryType is CU_MEMORYTYPE_DEVICE, dstDevice and dstPitch specify the (device) base address of the destination data, the bytes per row, and the height of each 2D slice of the 3D array. dstArray is ignored.
If dstMemoryType is CU_MEMORYTYPE_ARRAY, dstArray specifies the handle of the destination data. dstHost, dstDevice, dstPitch and dstHeight are ignored.
  • srcXInBytes, srcY and srcZ specify the base address of the source data for the copy.

For host pointers, the starting address is
  void* Start = (void*)((char*)srcHost+(srcZ*srcHeight+srcY)*srcPitch
 + srcXInBytes);
 
For device pointers, the starting address is
  CUdeviceptr Start =
 srcDevice+(srcZ*srcHeight+srcY)*srcPitch+srcXInBytes;
 
For CUDA arrays, srcXInBytes must be evenly divisible by the array element size.
  • dstXInBytes, dstY and dstZ specify the base address of the destination data for the copy.

For host pointers, the base address is
  void* dstStart = (void*)((char*)dstHost+(dstZ*dstHeight+dstY)*dstPitch
 + dstXInBytes);
 
For device pointers, the starting address is
  CUdeviceptr dstStart =
 dstDevice+(dstZ*dstHeight+dstY)*dstPitch+dstXInBytes;
 
For CUDA arrays, dstXInBytes must be evenly divisible by the array element size.
  • WidthInBytes, Height and Depth specify the width (in bytes), height and depth of the 3D copy being performed.
  • If specified, srcPitch must be greater than or equal to WidthInBytes + srcXInBytes, and dstPitch must be greater than or equal to WidthInBytes + dstXInBytes.
  • If specified, srcHeight must be greater than or equal to Height + srcY, and dstHeight must be greater than or equal to Height + dstY.

cuMemcpy3D() returns an error if any pitch is greater than the maximum allowed (CU_DEVICE_ATTRIBUTE_MAX_PITCH).
The srcLOD and dstLOD members of the CUDA_MEMCPY3D structure must be set to 0.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemcpy3DPeer

public static int cuMemcpy3DPeer(CUDA_MEMCPY3D_PEER pCopy)
Copies memory between contexts.
CUresult cuMemcpy3DPeer ( const CUDA_MEMCPY3D_PEER *  pCopy  ) 

Perform a 3D memory copy according to the parameters specified in pCopy. See the definition of the CUDA_MEMCPY3D_PEER structure for documentation of its parameters.

Note that this function is synchronous with respect to the host only if the source or destination memory is of type CU_MEMORYTYPE_HOST. Note also that this copy is serialized with respect all pending and future asynchronous work in to the current context, the copy's source context, and the copy's destination context (use cuMemcpy3DPeerAsync to avoid this synchronization).

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyPeer(jcuda.driver.CUdeviceptr, jcuda.driver.CUcontext, jcuda.driver.CUdeviceptr, jcuda.driver.CUcontext, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyPeerAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUcontext, jcuda.driver.CUdeviceptr, jcuda.driver.CUcontext, long, jcuda.driver.CUstream), cuMemcpy3DPeerAsync(jcuda.driver.CUDA_MEMCPY3D_PEER, jcuda.driver.CUstream)

cuMemcpyAsync

public static int cuMemcpyAsync(CUdeviceptr dst,
                                CUdeviceptr src,
                                long ByteCount,
                                CUstream hStream)
Copies memory asynchronously.
CUresult cuMemcpyAsync ( CUdeviceptr  dst,
CUdeviceptr  src,
size_t  ByteCount,
CUstream  hStream  
)

Copies data between two pointers. dst and src are base pointers of the destination and source, respectively. ByteCount specifies the number of bytes to copy. Note that this function infers the type of the transfer (host to host, host to device, device to device, or device to host) from the pointer values. This function is only allowed in contexts which support unified addressing. Note that this function is asynchronous and can optionally be associated to a stream by passing a non-zero hStream argument

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemcpyPeerAsync

public static int cuMemcpyPeerAsync(CUdeviceptr dstDevice,
                                    CUcontext dstContext,
                                    CUdeviceptr srcDevice,
                                    CUcontext srcContext,
                                    long ByteCount,
                                    CUstream hStream)
Copies device memory between two contexts.
CUresult cuMemcpyPeerAsync ( CUdeviceptr  dstDevice,
CUcontext  dstContext,
CUdeviceptr  srcDevice,
CUcontext  srcContext,
size_t  ByteCount,
CUstream  hStream  
)

Copies from device memory in one context to device memory in another context. dstDevice is the base device pointer of the destination memory and dstContext is the destination context. srcDevice is the base device pointer of the source memory and srcContext is the source pointer. ByteCount specifies the number of bytes to copy. Note that this function is asynchronous with respect to the host and all work in other streams in other devices.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyPeer(jcuda.driver.CUdeviceptr, jcuda.driver.CUcontext, jcuda.driver.CUdeviceptr, jcuda.driver.CUcontext, long), cuMemcpy3DPeer(jcuda.driver.CUDA_MEMCPY3D_PEER), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpy3DPeerAsync(jcuda.driver.CUDA_MEMCPY3D_PEER, jcuda.driver.CUstream)

cuMemcpyHtoDAsync

public static int cuMemcpyHtoDAsync(CUdeviceptr dstDevice,
                                    Pointer srcHost,
                                    long ByteCount,
                                    CUstream hStream)
Copies memory from Host to Device.
CUresult cuMemcpyHtoDAsync ( CUdeviceptr  dstDevice,
const void *  srcHost,
size_t  ByteCount,
CUstream  hStream  
)

Copies from host memory to device memory. dstDevice and srcHost are the base addresses of the destination and source, respectively. ByteCount specifies the number of bytes to copy.

cuMemcpyHtoDAsync() is asynchronous and can optionally be associated to a stream by passing a non-zero hStream argument. It only works on page-locked memory and returns an error if a pointer to pageable memory is passed as input.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemcpyDtoHAsync

public static int cuMemcpyDtoHAsync(Pointer dstHost,
                                    CUdeviceptr srcDevice,
                                    long ByteCount,
                                    CUstream hStream)
Copies memory from Device to Host.
CUresult cuMemcpyDtoHAsync ( void *  dstHost,
CUdeviceptr  srcDevice,
size_t  ByteCount,
CUstream  hStream  
)

Copies from device to host memory. dstHost and srcDevice specify the base pointers of the destination and source, respectively. ByteCount specifies the number of bytes to copy.

cuMemcpyDtoHAsync() is asynchronous and can optionally be associated to a stream by passing a non-zero hStream argument. It only works on page-locked memory and returns an error if a pointer to pageable memory is passed as input.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemcpyDtoDAsync

public static int cuMemcpyDtoDAsync(CUdeviceptr dstDevice,
                                    CUdeviceptr srcDevice,
                                    long ByteCount,
                                    CUstream hStream)
Copies memory from Device to Device.
CUresult cuMemcpyDtoDAsync ( CUdeviceptr  dstDevice,
CUdeviceptr  srcDevice,
size_t  ByteCount,
CUstream  hStream  
)

Copies from device memory to device memory. dstDevice and srcDevice are the base pointers of the destination and source, respectively. ByteCount specifies the number of bytes to copy. Note that this function is asynchronous and can optionally be associated to a stream by passing a non-zero hStream argument

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemcpyHtoAAsync

public static int cuMemcpyHtoAAsync(CUarray dstArray,
                                    long dstIndex,
                                    Pointer pSrc,
                                    long ByteCount,
                                    CUstream hStream)
Copies memory from Host to Array.
CUresult cuMemcpyHtoAAsync ( CUarray  dstArray,
size_t  dstOffset,
const void *  srcHost,
size_t  ByteCount,
CUstream  hStream  
)

Copies from host memory to a 1D CUDA array. dstArray and dstOffset specify the CUDA array handle and starting offset in bytes of the destination data. srcHost specifies the base address of the source. ByteCount specifies the number of bytes to copy.

cuMemcpyHtoAAsync() is asynchronous and can optionally be associated to a stream by passing a non-zero hStream argument. It only works on page-locked memory and returns an error if a pointer to pageable memory is passed as input.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemcpyAtoHAsync

public static int cuMemcpyAtoHAsync(Pointer dstHost,
                                    CUarray srcArray,
                                    long srcIndex,
                                    long ByteCount,
                                    CUstream hStream)
Copies memory from Array to Host.
CUresult cuMemcpyAtoHAsync ( void *  dstHost,
CUarray  srcArray,
size_t  srcOffset,
size_t  ByteCount,
CUstream  hStream  
)

Copies from one 1D CUDA array to host memory. dstHost specifies the base pointer of the destination. srcArray and srcOffset specify the CUDA array handle and starting offset in bytes of the source data. ByteCount specifies the number of bytes to copy.

cuMemcpyAtoHAsync() is asynchronous and can optionally be associated to a stream by passing a non-zero stream argument. It only works on page-locked host memory and returns an error if a pointer to pageable memory is passed as input.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemcpy2DAsync

public static int cuMemcpy2DAsync(CUDA_MEMCPY2D pCopy,
                                  CUstream hStream)
Copies memory for 2D arrays.
CUresult cuMemcpy2DAsync ( const CUDA_MEMCPY2D *  pCopy,
CUstream  hStream  
)

Perform a 2D memory copy according to the parameters specified in pCopy. The CUDA_MEMCPY2D structure is defined as:

   typedef struct CUDA_MEMCPY2D_st
 {
       unsigned int srcXInBytes, srcY;
       CUmemorytype srcMemoryType;
       const void *srcHost;
       CUdeviceptr srcDevice;
       CUarray srcArray;
       unsigned int srcPitch;
       unsigned int dstXInBytes, dstY;
       CUmemorytype dstMemoryType;
       void *dstHost;
       CUdeviceptr dstDevice;
       CUarray dstArray;
       unsigned int dstPitch;
       unsigned int WidthInBytes;
       unsigned int Height;
    } CUDA_MEMCPY2D;
 
where:
  • srcMemoryType and dstMemoryType specify the type of memory of the source and destination, respectively; CUmemorytype_enum is defined as:

   typedef enum CUmemorytype_enum
 {
       CU_MEMORYTYPE_HOST = 0x01,
       CU_MEMORYTYPE_DEVICE = 0x02,
       CU_MEMORYTYPE_ARRAY = 0x03,
       CU_MEMORYTYPE_UNIFIED = 0x04
    } CUmemorytype;
 

If srcMemoryType is CU_MEMORYTYPE_HOST, srcHost and srcPitch specify the (host) base address of the source data and the bytes per row to apply. srcArray is ignored.
If srcMemoryType is CU_MEMORYTYPE_UNIFIED, srcDevice and srcPitch specify the (unified virtual address space) base address of the source data and the bytes per row to apply. srcArray is ignored. This value may be used only if unified addressing is supported in the calling context.
If srcMemoryType is CU_MEMORYTYPE_DEVICE, srcDevice and srcPitch specify the (device) base address of the source data and the bytes per row to apply. srcArray is ignored.
If srcMemoryType is CU_MEMORYTYPE_ARRAY, srcArray specifies the handle of the source data. srcHost, srcDevice and srcPitch are ignored.
If dstMemoryType is CU_MEMORYTYPE_UNIFIED, dstDevice and dstPitch specify the (unified virtual address space) base address of the source data and the bytes per row to apply. dstArray is ignored. This value may be used only if unified addressing is supported in the calling context.
If dstMemoryType is CU_MEMORYTYPE_HOST, dstHost and dstPitch specify the (host) base address of the destination data and the bytes per row to apply. dstArray is ignored.
If dstMemoryType is CU_MEMORYTYPE_DEVICE, dstDevice and dstPitch specify the (device) base address of the destination data and the bytes per row to apply. dstArray is ignored.
If dstMemoryType is CU_MEMORYTYPE_ARRAY, dstArray specifies the handle of the destination data. dstHost, dstDevice and dstPitch are ignored.
  • srcXInBytes and srcY specify the base address of the source data for the copy.

For host pointers, the starting address is
  void* Start = (void*)((char*)srcHost+srcY*srcPitch +
 srcXInBytes);
 
For device pointers, the starting address is
  CUdeviceptr Start =
 srcDevice+srcY*srcPitch+srcXInBytes;
 
For CUDA arrays, srcXInBytes must be evenly divisible by the array element size.
  • dstXInBytes and dstY specify the base address of the destination data for the copy.

For host pointers, the base address is
  void* dstStart = (void*)((char*)dstHost+dstY*dstPitch +
 dstXInBytes);
 
For device pointers, the starting address is
  CUdeviceptr dstStart =
 dstDevice+dstY*dstPitch+dstXInBytes;
 
For CUDA arrays, dstXInBytes must be evenly divisible by the array element size.
  • WidthInBytes and Height specify the width (in bytes) and height of the 2D copy being performed.
  • If specified, srcPitch must be greater than or equal to WidthInBytes + srcXInBytes, and dstPitch must be greater than or equal to WidthInBytes + dstXInBytes.
  • If specified, srcPitch must be greater than or equal to WidthInBytes + srcXInBytes, and dstPitch must be greater than or equal to WidthInBytes + dstXInBytes.
  • If specified, srcHeight must be greater than or equal to Height + srcY, and dstHeight must be greater than or equal to Height + dstY.

cuMemcpy2D() returns an error if any pitch is greater than the maximum allowed (CU_DEVICE_ATTRIBUTE_MAX_PITCH). cuMemAllocPitch() passes back pitches that always work with cuMemcpy2D(). On intra-device memory copies (device to device, CUDA array to device, CUDA array to CUDA array), cuMemcpy2D() may fail for pitches not computed by cuMemAllocPitch(). cuMemcpy2DUnaligned() does not have this restriction, but may run significantly slower in the cases where cuMemcpy2D() would have returned an error code.
cuMemcpy2DAsync() is asynchronous and can optionally be associated to a stream by passing a non-zero hStream argument. It only works on page-locked host memory and returns an error if a pointer to pageable memory is passed as input.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemcpy3DAsync

public static int cuMemcpy3DAsync(CUDA_MEMCPY3D pCopy,
                                  CUstream hStream)
Copies memory for 3D arrays.
CUresult cuMemcpy3DAsync ( const CUDA_MEMCPY3D *  pCopy,
CUstream  hStream  
)

Perform a 3D memory copy according to the parameters specified in pCopy. The CUDA_MEMCPY3D structure is defined as:

        typedef struct
 CUDA_MEMCPY3D_st {

             unsigned int srcXInBytes, srcY,
 srcZ;
             unsigned int srcLOD;
             CUmemorytype srcMemoryType;
                 const void *srcHost;
                 CUdeviceptr srcDevice;
                 CUarray srcArray;
                 unsigned int srcPitch;
 // ignored when src is array
                 unsigned int srcHeight;
 // ignored when src is array; may be 0 if Depth==1

             unsigned int dstXInBytes, dstY,
 dstZ;
             unsigned int dstLOD;
             CUmemorytype dstMemoryType;
                 void *dstHost;
                 CUdeviceptr dstDevice;
                 CUarray dstArray;
                 unsigned int dstPitch;
 // ignored when dst is array
                 unsigned int dstHeight;
 // ignored when dst is array; may be 0 if Depth==1

             unsigned int WidthInBytes;
             unsigned int Height;
             unsigned int Depth;
         } CUDA_MEMCPY3D;
 
where:
  • srcMemoryType and dstMemoryType specify the type of memory of the source and destination, respectively; CUmemorytype_enum is defined as:

   typedef enum CUmemorytype_enum
 {
       CU_MEMORYTYPE_HOST = 0x01,
       CU_MEMORYTYPE_DEVICE = 0x02,
       CU_MEMORYTYPE_ARRAY = 0x03,
       CU_MEMORYTYPE_UNIFIED = 0x04
    } CUmemorytype;
 

If srcMemoryType is CU_MEMORYTYPE_UNIFIED, srcDevice and srcPitch specify the (unified virtual address space) base address of the source data and the bytes per row to apply. srcArray is ignored. This value may be used only if unified addressing is supported in the calling context.
If srcMemoryType is CU_MEMORYTYPE_HOST, srcHost, srcPitch and srcHeight specify the (host) base address of the source data, the bytes per row, and the height of each 2D slice of the 3D array. srcArray is ignored.
If srcMemoryType is CU_MEMORYTYPE_DEVICE, srcDevice, srcPitch and srcHeight specify the (device) base address of the source data, the bytes per row, and the height of each 2D slice of the 3D array. srcArray is ignored.
If srcMemoryType is CU_MEMORYTYPE_ARRAY, srcArray specifies the handle of the source data. srcHost, srcDevice, srcPitch and srcHeight are ignored.
If dstMemoryType is CU_MEMORYTYPE_UNIFIED, dstDevice and dstPitch specify the (unified virtual address space) base address of the source data and the bytes per row to apply. dstArray is ignored. This value may be used only if unified addressing is supported in the calling context.
If dstMemoryType is CU_MEMORYTYPE_HOST, dstHost and dstPitch specify the (host) base address of the destination data, the bytes per row, and the height of each 2D slice of the 3D array. dstArray is ignored.
If dstMemoryType is CU_MEMORYTYPE_DEVICE, dstDevice and dstPitch specify the (device) base address of the destination data, the bytes per row, and the height of each 2D slice of the 3D array. dstArray is ignored.
If dstMemoryType is CU_MEMORYTYPE_ARRAY, dstArray specifies the handle of the destination data. dstHost, dstDevice, dstPitch and dstHeight are ignored.
  • srcXInBytes, srcY and srcZ specify the base address of the source data for the copy.

For host pointers, the starting address is
  void* Start = (void*)((char*)srcHost+(srcZ*srcHeight+srcY)*srcPitch
 + srcXInBytes);
 
For device pointers, the starting address is
  CUdeviceptr Start =
 srcDevice+(srcZ*srcHeight+srcY)*srcPitch+srcXInBytes;
 
For CUDA arrays, srcXInBytes must be evenly divisible by the array element size.
  • dstXInBytes, dstY and dstZ specify the base address of the destination data for the copy.

For host pointers, the base address is
  void* dstStart = (void*)((char*)dstHost+(dstZ*dstHeight+dstY)*dstPitch
 + dstXInBytes);
 
For device pointers, the starting address is
  CUdeviceptr dstStart =
 dstDevice+(dstZ*dstHeight+dstY)*dstPitch+dstXInBytes;
 
For CUDA arrays, dstXInBytes must be evenly divisible by the array element size.
  • WidthInBytes, Height and Depth specify the width (in bytes), height and depth of the 3D copy being performed.
  • If specified, srcPitch must be greater than or equal to WidthInBytes + srcXInBytes, and dstPitch must be greater than or equal to WidthInBytes + dstXInBytes.
  • If specified, srcHeight must be greater than or equal to Height + srcY, and dstHeight must be greater than or equal to Height + dstY.

cuMemcpy3D() returns an error if any pitch is greater than the maximum allowed (CU_DEVICE_ATTRIBUTE_MAX_PITCH).
cuMemcpy3DAsync() is asynchronous and can optionally be associated to a stream by passing a non-zero hStream argument. It only works on page-locked host memory and returns an error if a pointer to pageable memory is passed as input.

The srcLOD and dstLOD members of the CUDA_MEMCPY3D structure must be set to 0.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemcpy3DPeerAsync

public static int cuMemcpy3DPeerAsync(CUDA_MEMCPY3D_PEER pCopy,
                                      CUstream hStream)
Copies memory between contexts.
CUresult cuMemcpy3DPeerAsync ( const CUDA_MEMCPY3D_PEER *  pCopy,
CUstream  hStream  
)

Perform a 3D memory copy according to the parameters specified in pCopy. See the definition of the CUDA_MEMCPY3D_PEER structure for documentation of its parameters.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyPeer(jcuda.driver.CUdeviceptr, jcuda.driver.CUcontext, jcuda.driver.CUdeviceptr, jcuda.driver.CUcontext, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyPeerAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUcontext, jcuda.driver.CUdeviceptr, jcuda.driver.CUcontext, long, jcuda.driver.CUstream), cuMemcpy3DPeerAsync(jcuda.driver.CUDA_MEMCPY3D_PEER, jcuda.driver.CUstream)

cuMemsetD8

public static int cuMemsetD8(CUdeviceptr dstDevice,
                             byte uc,
                             long N)
Sets device memory.
CUresult cuMemsetD8 ( CUdeviceptr  dstDevice,
unsigned char  uc,
size_t  N  
)

Sets the memory range of N 8-bit values to the specified value uc.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemsetD16

public static int cuMemsetD16(CUdeviceptr dstDevice,
                              short us,
                              long N)
Initializes device memory.
CUresult cuMemsetD16 ( CUdeviceptr  dstDevice,
unsigned short  us,
size_t  N  
)

Sets the memory range of N 16-bit values to the specified value us. The dstDevice pointer must be two byte aligned.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemsetD32

public static int cuMemsetD32(CUdeviceptr dstDevice,
                              int ui,
                              long N)
Sets device memory.
CUresult cuMemsetD32 ( CUdeviceptr  dstDevice,
unsigned int  ui,
size_t  N  
)

Sets the memory range of N 32-bit values to the specified value ui. The dstDevice pointer must be four byte aligned.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemsetD2D8

public static int cuMemsetD2D8(CUdeviceptr dstDevice,
                               long dstPitch,
                               byte uc,
                               long Width,
                               long Height)
Sets device memory.
CUresult cuMemsetD2D8 ( CUdeviceptr  dstDevice,
size_t  dstPitch,
unsigned char  uc,
size_t  Width,
size_t  Height  
)

Sets the 2D memory range of Width 8-bit values to the specified value uc. Height specifies the number of rows to set, and dstPitch specifies the number of bytes between each row. This function performs fastest when the pitch is one that has been passed back by cuMemAllocPitch().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemsetD2D16

public static int cuMemsetD2D16(CUdeviceptr dstDevice,
                                long dstPitch,
                                short us,
                                long Width,
                                long Height)
Sets device memory.
CUresult cuMemsetD2D16 ( CUdeviceptr  dstDevice,
size_t  dstPitch,
unsigned short  us,
size_t  Width,
size_t  Height  
)

Sets the 2D memory range of Width 16-bit values to the specified value us. Height specifies the number of rows to set, and dstPitch specifies the number of bytes between each row. The dstDevice pointer and dstPitch offset must be two byte aligned. This function performs fastest when the pitch is one that has been passed back by cuMemAllocPitch().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemsetD2D32

public static int cuMemsetD2D32(CUdeviceptr dstDevice,
                                long dstPitch,
                                int ui,
                                long Width,
                                long Height)
Sets device memory.
CUresult cuMemsetD2D32 ( CUdeviceptr  dstDevice,
size_t  dstPitch,
unsigned int  ui,
size_t  Width,
size_t  Height  
)

Sets the 2D memory range of Width 32-bit values to the specified value ui. Height specifies the number of rows to set, and dstPitch specifies the number of bytes between each row. The dstDevice pointer and dstPitch offset must be four byte aligned. This function performs fastest when the pitch is one that has been passed back by cuMemAllocPitch().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemsetD8Async

public static int cuMemsetD8Async(CUdeviceptr dstDevice,
                                  byte uc,
                                  long N,
                                  CUstream hStream)
Initializes device memory.
CUresult cuMemsetD8Async ( CUdeviceptr  dstDevice,
unsigned char  uc,
size_t  N,
CUstream  hStream  
)

Sets the memory range of N 8-bit values to the specified value uc.

cuMemsetD8Async() is asynchronous and can optionally be associated to a stream by passing a non-zero stream argument.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemsetD16Async

public static int cuMemsetD16Async(CUdeviceptr dstDevice,
                                   short us,
                                   long N,
                                   CUstream hStream)
Initializes device memory.
CUresult cuMemsetD16Async ( CUdeviceptr  dstDevice,
unsigned short  us,
size_t  N,
CUstream  hStream  
)

Sets the memory range of N 16-bit values to the specified value us. The dstDevice pointer must be two byte aligned.

cuMemsetD16Async() is asynchronous and can optionally be associated to a stream by passing a non-zero stream argument.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemsetD32Async

public static int cuMemsetD32Async(CUdeviceptr dstDevice,
                                   int ui,
                                   long N,
                                   CUstream hStream)
Initializes device memory.
CUresult cuMemsetD32Async ( CUdeviceptr  dstDevice,
unsigned int  ui,
size_t  N,
CUstream  hStream  
)

Sets the memory range of N 32-bit values to the specified value ui. The dstDevice pointer must be four byte aligned.

cuMemsetD32Async() is asynchronous and can optionally be associated to a stream by passing a non-zero stream argument.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMemsetD2D8Async

public static int cuMemsetD2D8Async(CUdeviceptr dstDevice,
                                    long dstPitch,
                                    byte uc,
                                    long Width,
                                    long Height,
                                    CUstream hStream)
Initializes device memory.
CUresult cuMemsetD2D8Async ( CUdeviceptr  dstDevice,
size_t  dstPitch,
unsigned char  uc,
size_t  Width,
size_t  Height,
CUstream  hStream  
)

Sets the 2D memory range of Width 8-bit values to the specified value uc. Height specifies the number of rows to set, and dstPitch specifies the number of bytes between each row. This function performs fastest when the pitch is one that has been passed back by cuMemAllocPitch().

cuMemsetD2D8Async() is asynchronous and can optionally be associated to a stream by passing a non-zero stream argument.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemsetD2D16Async

public static int cuMemsetD2D16Async(CUdeviceptr dstDevice,
                                     long dstPitch,
                                     short us,
                                     long Width,
                                     long Height,
                                     CUstream hStream)
Initializes device memory.
CUresult cuMemsetD2D16Async ( CUdeviceptr  dstDevice,
size_t  dstPitch,
unsigned short  us,
size_t  Width,
size_t  Height,
CUstream  hStream  
)

Sets the 2D memory range of Width 16-bit values to the specified value us. Height specifies the number of rows to set, and dstPitch specifies the number of bytes between each row. The dstDevice pointer and dstPitch offset must be two byte aligned. This function performs fastest when the pitch is one that has been passed back by cuMemAllocPitch().

cuMemsetD2D16Async() is asynchronous and can optionally be associated to a stream by passing a non-zero stream argument.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD2D32Async(jcuda.driver.CUdeviceptr, long, int, long, long, jcuda.driver.CUstream), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuMemsetD2D32Async

public static int cuMemsetD2D32Async(CUdeviceptr dstDevice,
                                     long dstPitch,
                                     int ui,
                                     long Width,
                                     long Height,
                                     CUstream hStream)
Initializes device memory.
CUresult cuMemsetD2D32Async ( CUdeviceptr  dstDevice,
size_t  dstPitch,
unsigned int  ui,
size_t  Width,
size_t  Height,
CUstream  hStream  
)

Sets the 2D memory range of Width 32-bit values to the specified value ui. Height specifies the number of rows to set, and dstPitch specifies the number of bytes between each row. The dstDevice pointer and dstPitch offset must be four byte aligned. This function performs fastest when the pitch is one that has been passed back by cuMemAllocPitch().

cuMemsetD2D32Async() is asynchronous and can optionally be associated to a stream by passing a non-zero stream argument.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D8Async(jcuda.driver.CUdeviceptr, long, byte, long, long, jcuda.driver.CUstream), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D16Async(jcuda.driver.CUdeviceptr, long, short, long, long, jcuda.driver.CUstream), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD8Async(jcuda.driver.CUdeviceptr, byte, long, jcuda.driver.CUstream), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD16Async(jcuda.driver.CUdeviceptr, short, long, jcuda.driver.CUstream), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long), cuMemsetD32Async(jcuda.driver.CUdeviceptr, int, long, jcuda.driver.CUstream)

cuFuncGetAttribute

public static int cuFuncGetAttribute(int[] pi,
                                     int attrib,
                                     CUfunction func)
Returns information about a function.
CUresult cuFuncGetAttribute ( int *  pi,
CUfunction_attribute  attrib,
CUfunction  hfunc  
)

Returns in *pi the integer value of the attribute attrib on the kernel given by hfunc. The supported attributes are:

  • CU_FUNC_ATTRIBUTE_MAX_THREADS_PER_BLOCK: The maximum number of threads per block, beyond which a launch of the function would fail. This number depends on both the function and the device on which the function is currently loaded.
  • CU_FUNC_ATTRIBUTE_SHARED_SIZE_BYTES: The size in bytes of statically-allocated shared memory per block required by this function. This does not include dynamically-allocated shared memory requested by the user at runtime.
  • CU_FUNC_ATTRIBUTE_CONST_SIZE_BYTES: The size in bytes of user-allocated constant memory required by this function.
  • CU_FUNC_ATTRIBUTE_LOCAL_SIZE_BYTES: The size in bytes of local memory used by each thread of this function.
  • CU_FUNC_ATTRIBUTE_NUM_REGS: The number of registers used by each thread of this function.
  • CU_FUNC_ATTRIBUTE_PTX_VERSION: The PTX virtual architecture version for which the function was compiled. This value is the major PTX version * 10 + the minor PTX version, so a PTX version 1.3 function would return the value 13. Note that this may return the undefined value of 0 for cubins compiled prior to CUDA 3.0.
  • CU_FUNC_ATTRIBUTE_BINARY_VERSION: The binary architecture version for which the function was compiled. This value is the major binary version * 10 + the minor binary version, so a binary version 1.3 function would return the value 13. Note that this will return a value of 10 for legacy cubins that do not have a properly-encoded binary architecture version.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_INVALID_VALUE
See Also:
cuCtxGetCacheConfig(int[]), cuCtxSetCacheConfig(int), cuFuncSetCacheConfig(jcuda.driver.CUfunction, int), cuLaunchKernel(jcuda.driver.CUfunction, int, int, int, int, int, int, int, jcuda.driver.CUstream, jcuda.Pointer, jcuda.Pointer)

cuFuncSetBlockShape

public static int cuFuncSetBlockShape(CUfunction hfunc,
                                      int x,
                                      int y,
                                      int z)
Deprecated. This function is deprecated in the latest CUDA version

Sets the block-dimensions for the function.
CUresult cuFuncSetBlockShape ( CUfunction  hfunc,
int  x,
int  y,
int  z  
)

Deprecated:
Specifies the x, y, and z dimensions of the thread blocks that are created when the kernel given by hfunc is launched.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_INVALID_VALUE
See Also:
cuFuncSetSharedSize(jcuda.driver.CUfunction, int), cuFuncSetCacheConfig(jcuda.driver.CUfunction, int), cuFuncGetAttribute(int[], int, jcuda.driver.CUfunction), cuParamSetSize(jcuda.driver.CUfunction, int), cuParamSeti(jcuda.driver.CUfunction, int, int), cuParamSetf(jcuda.driver.CUfunction, int, float), cuParamSetv(jcuda.driver.CUfunction, int, jcuda.Pointer, int), cuLaunch(jcuda.driver.CUfunction), cuLaunchGrid(jcuda.driver.CUfunction, int, int), cuLaunchGridAsync(jcuda.driver.CUfunction, int, int, jcuda.driver.CUstream), cuLaunchKernel(jcuda.driver.CUfunction, int, int, int, int, int, int, int, jcuda.driver.CUstream, jcuda.Pointer, jcuda.Pointer)

cuFuncSetSharedSize

public static int cuFuncSetSharedSize(CUfunction hfunc,
                                      int bytes)
Deprecated. This function is deprecated in the latest CUDA version

Sets the dynamic shared-memory size for the function.
CUresult cuFuncSetSharedSize ( CUfunction  hfunc,
unsigned int  bytes  
)

Deprecated:
Sets through bytes the amount of dynamic shared memory that will be available to each thread block when the kernel given by hfunc is launched.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_INVALID_VALUE
See Also:
cuFuncSetBlockShape(jcuda.driver.CUfunction, int, int, int), cuFuncSetCacheConfig(jcuda.driver.CUfunction, int), cuFuncGetAttribute(int[], int, jcuda.driver.CUfunction), cuParamSetSize(jcuda.driver.CUfunction, int), cuParamSeti(jcuda.driver.CUfunction, int, int), cuParamSetf(jcuda.driver.CUfunction, int, float), cuParamSetv(jcuda.driver.CUfunction, int, jcuda.Pointer, int), cuLaunch(jcuda.driver.CUfunction), cuLaunchGrid(jcuda.driver.CUfunction, int, int), cuLaunchGridAsync(jcuda.driver.CUfunction, int, int, jcuda.driver.CUstream), cuLaunchKernel(jcuda.driver.CUfunction, int, int, int, int, int, int, int, jcuda.driver.CUstream, jcuda.Pointer, jcuda.Pointer)

cuFuncSetCacheConfig

public static int cuFuncSetCacheConfig(CUfunction hfunc,
                                       int config)
Sets the preferred cache configuration for a device function.
CUresult cuFuncSetCacheConfig ( CUfunction  hfunc,
CUfunc_cache  config  
)

On devices where the L1 cache and shared memory use the same hardware resources, this sets through config the preferred cache configuration for the device function hfunc. This is only a preference. The driver will use the requested configuration if possible, but it is free to choose a different configuration if required to execute hfunc. Any context-wide preference set via cuCtxSetCacheConfig() will be overridden by this per-function setting unless the per-function setting is CU_FUNC_CACHE_PREFER_NONE. In that case, the current context-wide setting will be used.

This setting does nothing on devices where the size of the L1 cache and shared memory are fixed.

Launching a kernel with a different preference than the most recent preference setting may insert a device-side synchronization point.

The supported cache configurations are:

  • CU_FUNC_CACHE_PREFER_NONE: no preference for shared memory or L1 (default)
  • CU_FUNC_CACHE_PREFER_SHARED: prefer larger shared memory and smaller L1 cache
  • CU_FUNC_CACHE_PREFER_L1: prefer larger L1 cache and smaller shared memory
  • CU_FUNC_CACHE_PREFER_EQUAL: prefer equal sized L1 cache and shared memory

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT
See Also:
cuCtxGetCacheConfig(int[]), cuCtxSetCacheConfig(int), cuFuncGetAttribute(int[], int, jcuda.driver.CUfunction), cuLaunchKernel(jcuda.driver.CUfunction, int, int, int, int, int, int, int, jcuda.driver.CUstream, jcuda.Pointer, jcuda.Pointer)

cuFuncSetSharedMemConfig

public static int cuFuncSetSharedMemConfig(CUfunction hfunc,
                                           int config)
(Not available in CUDA 4.2) Sets the shared memory configuration for the given function

Parameters:
hfunc - The function
config - The configuration
Returns:
The error return code
Throws:
java.lang.UnsupportedOperationException - Since this function is not available in CUDA 4.2

cuArrayCreate

public static int cuArrayCreate(CUarray pHandle,
                                CUDA_ARRAY_DESCRIPTOR pAllocateArray)
Creates a 1D or 2D CUDA array.
CUresult cuArrayCreate ( CUarray *  pHandle,
const CUDA_ARRAY_DESCRIPTOR *  pAllocateArray  
)

Creates a CUDA array according to the CUDA_ARRAY_DESCRIPTOR structure pAllocateArray and returns a handle to the new CUDA array in *pHandle. The CUDA_ARRAY_DESCRIPTOR is defined as:

    typedef struct {
         unsigned int Width;
         unsigned int Height;
         CUarray_format Format;
         unsigned int NumChannels;
     } CUDA_ARRAY_DESCRIPTOR;
 
where:

  • Width, and Height are the width, and height of the CUDA array (in elements); the CUDA array is one-dimensional if height is 0, two-dimensional otherwise;
  • Format specifies the format of the elements; CUarray_format is defined as:
        typedef enum CUarray_format_enum {
             CU_AD_FORMAT_UNSIGNED_INT8 = 0x01,
             CU_AD_FORMAT_UNSIGNED_INT16 = 0x02,
             CU_AD_FORMAT_UNSIGNED_INT32 = 0x03,
             CU_AD_FORMAT_SIGNED_INT8 = 0x08,
             CU_AD_FORMAT_SIGNED_INT16 = 0x09,
             CU_AD_FORMAT_SIGNED_INT32 = 0x0a,
             CU_AD_FORMAT_HALF = 0x10,
             CU_AD_FORMAT_FLOAT = 0x20
         } CUarray_format;
     
  • NumChannels specifies the number of packed components per CUDA array element; it may be 1, 2, or 4;

Here are examples of CUDA array descriptions:

Description for a CUDA array of 2048 floats:

 CUDA_ARRAY_DESCRIPTOR desc;
     desc.Format = CU_AD_FORMAT_FLOAT;
     desc.NumChannels = 1;
     desc.Width = 2048;
     desc.Height = 1;
 

Description for a 64 x 64 CUDA array of floats:

 CUDA_ARRAY_DESCRIPTOR desc;
     desc.Format = CU_AD_FORMAT_FLOAT;
     desc.NumChannels = 1;
     desc.Width = 64;
     desc.Height = 64;
 

Description for a width x height CUDA array of 64-bit, 4x16-bit float16's:

    CUDA_ARRAY_DESCRIPTOR
 desc;
     desc.FormatFlags = CU_AD_FORMAT_HALF;
     desc.NumChannels = 4;
     desc.Width = width;
     desc.Height = height;
 

Description for a width x height CUDA array of 16-bit elements, each of which is two 8-bit unsigned chars:

    CUDA_ARRAY_DESCRIPTOR arrayDesc;
     desc.FormatFlags = CU_AD_FORMAT_UNSIGNED_INT8;
     desc.NumChannels = 2;
     desc.Width = width;
     desc.Height = height;
 

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY, CUDA_ERROR_UNKNOWN
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuArrayGetDescriptor

public static int cuArrayGetDescriptor(CUDA_ARRAY_DESCRIPTOR pArrayDescriptor,
                                       CUarray hArray)
Get a 1D or 2D CUDA array descriptor.
CUresult cuArrayGetDescriptor ( CUDA_ARRAY_DESCRIPTOR *  pArrayDescriptor,
CUarray  hArray  
)

Returns in *pArrayDescriptor a descriptor containing information on the format and dimensions of the CUDA array hArray. It is useful for subroutines that have been passed a CUDA array, but need to know the CUDA array parameters for validation or other purposes.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuArrayDestroy

public static int cuArrayDestroy(CUarray hArray)
Destroys a CUDA array.
CUresult cuArrayDestroy ( CUarray  hArray  ) 

Destroys the CUDA array hArray.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_ARRAY_IS_MAPPED
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuArray3DCreate

public static int cuArray3DCreate(CUarray pHandle,
                                  CUDA_ARRAY3D_DESCRIPTOR pAllocateArray)
Creates a 3D CUDA array.
CUresult cuArray3DCreate ( CUarray *  pHandle,
const CUDA_ARRAY3D_DESCRIPTOR *  pAllocateArray  
)

Creates a CUDA array according to the CUDA_ARRAY3D_DESCRIPTOR structure pAllocateArray and returns a handle to the new CUDA array in *pHandle. The CUDA_ARRAY3D_DESCRIPTOR is defined as:

    typedef struct {
         unsigned int Width;
         unsigned int Height;
         unsigned int Depth;
         CUarray_format Format;
         unsigned int NumChannels;
         unsigned int Flags;
     } CUDA_ARRAY3D_DESCRIPTOR;
 
where:

  • Width, Height, and Depth are the width, height, and depth of the CUDA array (in elements); the following types of CUDA arrays can be allocated:
    • A 1D array is allocated if Height and Depth extents are both zero.
    • A 2D array is allocated if only Depth extent is zero.
    • A 3D array is allocated if all three extents are non-zero.
    • A 1D layered CUDA array is allocated if only Height is zero and the CUDA_ARRAY3D_LAYERED flag is set. Each layer is a 1D array. The number of layers is determined by the depth extent.
    • A 2D layered CUDA array is allocated if all three extents are non-zero and the CUDA_ARRAY3D_LAYERED flag is set. Each layer is a 2D array. The number of layers is determined by the depth extent.
    • A cubemap CUDA array is allocated if all three extents are non-zero and the CUDA_ARRAY3D_CUBEMAP flag is set. Width must be equal to Height, and Depth must be six. A cubemap is a special type of 2D layered CUDA array, where the six layers represent the six faces of a cube. The order of the six layers in memory is the same as that listed in CUarray_cubemap_face.
    • A cubemap layered CUDA array is allocated if all three extents are non-zero, and both, CUDA_ARRAY3D_CUBEMAP and CUDA_ARRAY3D_LAYERED flags are set. Width must be equal to Height, and Depth must be a multiple of six. A cubemap layered CUDA array is a special type of 2D layered CUDA array that consists of a collection of cubemaps. The first six layers represent the first cubemap, the next six layers form the second cubemap, and so on.

  • Format specifies the format of the elements; CUarray_format is defined as:
        typedef enum
     CUarray_format_enum {
             CU_AD_FORMAT_UNSIGNED_INT8 = 0x01,
             CU_AD_FORMAT_UNSIGNED_INT16 = 0x02,
             CU_AD_FORMAT_UNSIGNED_INT32 = 0x03,
             CU_AD_FORMAT_SIGNED_INT8 = 0x08,
             CU_AD_FORMAT_SIGNED_INT16 = 0x09,
             CU_AD_FORMAT_SIGNED_INT32 = 0x0a,
             CU_AD_FORMAT_HALF = 0x10,
             CU_AD_FORMAT_FLOAT = 0x20
         } CUarray_format;
     

  • NumChannels specifies the number of packed components per CUDA array element; it may be 1, 2, or 4;

  • Flags may be set to
    • CUDA_ARRAY3D_LAYERED to enable creation of layered CUDA arrays. If this flag is set, Depth specifies the number of layers, not the depth of a 3D array.
    • CUDA_ARRAY3D_SURFACE_LDST to enable surface references to be bound to the CUDA array. If this flag is not set, cuSurfRefSetArray will fail when attempting to bind the CUDA array to a surface reference.
    • CUDA_ARRAY3D_CUBEMAP to enable creation of cubemaps. If this flag is set, Width must be equal to Height, and Depth must be six. If the CUDA_ARRAY3D_LAYERED flag is also set, then Depth must be a multiple of six.
    • CUDA_ARRAY3D_TEXTURE_GATHER to indicate that the CUDA array will be used for texture gather. Texture gather can only be performed on 2D CUDA arrays.

Width, Height and Depth must meet certain size requirements as listed in the following table. All values are specified in elements. Note that for brevity's sake, the full name of the device attribute is not specified. For ex., TEXTURE1D_WIDTH refers to the device attribute CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE1D_WIDTH.

Note that 2D CUDA arrays have different size requirements if the CUDA_ARRAY3D_TEXTURE_GATHER flag is set. Width and Height must not be greater than CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_GATHER_WIDTH and CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_GATHER_HEIGHT respectively, in that case.

CUDA array type Valid extents that must always be met
{(width range in elements), (height range), (depth range)}
Valid extents with CUDA_ARRAY3D_SURFACE_LDST set
{(width range in elements), (height range), (depth range)}
1D { (1,TEXTURE1D_WIDTH), 0, 0 } { (1,SURFACE1D_WIDTH), 0, 0 }
2D { (1,TEXTURE2D_WIDTH), (1,TEXTURE2D_HEIGHT), 0 } { (1,SURFACE2D_WIDTH), (1,SURFACE2D_HEIGHT), 0 }
3D { (1,TEXTURE3D_WIDTH), (1,TEXTURE3D_HEIGHT), (1,TEXTURE3D_DEPTH) }
OR
{ (1,TEXTURE3D_WIDTH_ALTERNATE), (1,TEXTURE3D_HEIGHT_ALTERNATE), (1,TEXTURE3D_DEPTH_ALTERNATE) }
{ (1,SURFACE3D_WIDTH), (1,SURFACE3D_HEIGHT), (1,SURFACE3D_DEPTH) }
1D Layered { (1,TEXTURE1D_LAYERED_WIDTH), 0, (1,TEXTURE1D_LAYERED_LAYERS) } { (1,SURFACE1D_LAYERED_WIDTH), 0, (1,SURFACE1D_LAYERED_LAYERS) }
2D Layered { (1,TEXTURE2D_LAYERED_WIDTH), (1,TEXTURE2D_LAYERED_HEIGHT), (1,TEXTURE2D_LAYERED_LAYERS) } { (1,SURFACE2D_LAYERED_WIDTH), (1,SURFACE2D_LAYERED_HEIGHT), (1,SURFACE2D_LAYERED_LAYERS) }
Cubemap { (1,TEXTURECUBEMAP_WIDTH), (1,TEXTURECUBEMAP_WIDTH), 6 } { (1,SURFACECUBEMAP_WIDTH), (1,SURFACECUBEMAP_WIDTH), 6 }
Cubemap Layered { (1,TEXTURECUBEMAP_LAYERED_WIDTH), (1,TEXTURECUBEMAP_LAYERED_WIDTH), (1,TEXTURECUBEMAP_LAYERED_LAYERS) } { (1,SURFACECUBEMAP_LAYERED_WIDTH), (1,SURFACECUBEMAP_LAYERED_WIDTH), (1,SURFACECUBEMAP_LAYERED_LAYERS) }

Here are examples of CUDA array descriptions:

Description for a CUDA array of 2048 floats:

 CUDA_ARRAY3D_DESCRIPTOR desc;
     desc.Format = CU_AD_FORMAT_FLOAT;
     desc.NumChannels = 1;
     desc.Width = 2048;
     desc.Height = 0;
     desc.Depth = 0;
 

Description for a 64 x 64 CUDA array of floats:

 CUDA_ARRAY3D_DESCRIPTOR desc;
     desc.Format = CU_AD_FORMAT_FLOAT;
     desc.NumChannels = 1;
     desc.Width = 64;
     desc.Height = 64;
     desc.Depth = 0;
 

Description for a width x height x depth CUDA array of 64-bit, 4x16-bit float16's:

    CUDA_ARRAY3D_DESCRIPTOR desc;
     desc.FormatFlags = CU_AD_FORMAT_HALF;
     desc.NumChannels = 4;
     desc.Width = width;
     desc.Height = height;
     desc.Depth = depth;
 

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY, CUDA_ERROR_UNKNOWN
See Also:
cuArray3DGetDescriptor(jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR, jcuda.driver.CUarray), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuArray3DGetDescriptor

public static int cuArray3DGetDescriptor(CUDA_ARRAY3D_DESCRIPTOR pArrayDescriptor,
                                         CUarray hArray)
Get a 3D CUDA array descriptor.
CUresult cuArray3DGetDescriptor ( CUDA_ARRAY3D_DESCRIPTOR *  pArrayDescriptor,
CUarray  hArray  
)

Returns in *pArrayDescriptor a descriptor containing information on the format and dimensions of the CUDA array hArray. It is useful for subroutines that have been passed a CUDA array, but need to know the CUDA array parameters for validation or other purposes.

This function may be called on 1D and 2D arrays, in which case the Height and/or Depth members of the descriptor struct will be set to 0.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE
See Also:
cuArray3DCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY3D_DESCRIPTOR), cuArrayCreate(jcuda.driver.CUarray, jcuda.driver.CUDA_ARRAY_DESCRIPTOR), cuArrayDestroy(jcuda.driver.CUarray), cuArrayGetDescriptor(jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUarray), cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemAllocHost(jcuda.Pointer, long), cuMemAllocPitch(jcuda.driver.CUdeviceptr, long[], long, long, int), cuMemcpy2D(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy2DAsync(jcuda.driver.CUDA_MEMCPY2D, jcuda.driver.CUstream), cuMemcpy2DUnaligned(jcuda.driver.CUDA_MEMCPY2D), cuMemcpy3D(jcuda.driver.CUDA_MEMCPY3D), cuMemcpy3DAsync(jcuda.driver.CUDA_MEMCPY3D, jcuda.driver.CUstream), cuMemcpyAtoA(jcuda.driver.CUarray, long, jcuda.driver.CUarray, long, long), cuMemcpyAtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUarray, long, long), cuMemcpyAtoH(jcuda.Pointer, jcuda.driver.CUarray, long, long), cuMemcpyAtoHAsync(jcuda.Pointer, jcuda.driver.CUarray, long, long, jcuda.driver.CUstream), cuMemcpyDtoA(jcuda.driver.CUarray, long, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoD(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoDAsync(jcuda.driver.CUdeviceptr, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyDtoH(jcuda.Pointer, jcuda.driver.CUdeviceptr, long), cuMemcpyDtoHAsync(jcuda.Pointer, jcuda.driver.CUdeviceptr, long, jcuda.driver.CUstream), cuMemcpyHtoA(jcuda.driver.CUarray, long, jcuda.Pointer, long), cuMemcpyHtoAAsync(jcuda.driver.CUarray, long, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemcpyHtoD(jcuda.driver.CUdeviceptr, jcuda.Pointer, long), cuMemcpyHtoDAsync(jcuda.driver.CUdeviceptr, jcuda.Pointer, long, jcuda.driver.CUstream), cuMemFree(jcuda.driver.CUdeviceptr), cuMemFreeHost(jcuda.Pointer), cuMemGetAddressRange(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUdeviceptr), cuMemGetInfo(long[], long[]), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostGetDevicePointer(jcuda.driver.CUdeviceptr, jcuda.Pointer, int), cuMemsetD2D8(jcuda.driver.CUdeviceptr, long, byte, long, long), cuMemsetD2D16(jcuda.driver.CUdeviceptr, long, short, long, long), cuMemsetD2D32(jcuda.driver.CUdeviceptr, long, int, long, long), cuMemsetD8(jcuda.driver.CUdeviceptr, byte, long), cuMemsetD16(jcuda.driver.CUdeviceptr, short, long), cuMemsetD32(jcuda.driver.CUdeviceptr, int, long)

cuMipmappedArrayCreate

public static int cuMipmappedArrayCreate(CUmipmappedArray pHandle,
                                         CUDA_ARRAY3D_DESCRIPTOR pMipmappedArrayDesc,
                                         int numMipmapLevels)

cuMipmappedArrayGetLevel

public static int cuMipmappedArrayGetLevel(CUarray pLevelArray,
                                           CUmipmappedArray hMipmappedArray,
                                           int level)

cuMipmappedArrayDestroy

public static int cuMipmappedArrayDestroy(CUmipmappedArray hMipmappedArray)

cuTexRefCreate

public static int cuTexRefCreate(CUtexref pTexRef)
Deprecated. This function is deprecated in the latest CUDA version

Creates a texture reference.
CUresult cuTexRefCreate ( CUtexref *  pTexRef  ) 

Deprecated:
Creates a texture reference and returns its handle in *pTexRef. Once created, the application must call cuTexRefSetArray() or cuTexRefSetAddress() to associate the reference with allocated memory. Other texture reference functions are used to specify the format and interpretation (addressing, filtering, etc.) to be used when the memory is read through this texture reference.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefDestroy(jcuda.driver.CUtexref)

cuTexRefDestroy

public static int cuTexRefDestroy(CUtexref hTexRef)
Deprecated. This function is deprecated in the latest CUDA version

Destroys a texture reference.
CUresult cuTexRefDestroy ( CUtexref  hTexRef  ) 

Deprecated:
Destroys the texture reference specified by hTexRef.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefCreate(jcuda.driver.CUtexref)

cuTexRefSetArray

public static int cuTexRefSetArray(CUtexref hTexRef,
                                   CUarray hArray,
                                   int Flags)
Binds an array as a texture reference.
CUresult cuTexRefSetArray ( CUtexref  hTexRef,
CUarray  hArray,
unsigned int  Flags  
)

Binds the CUDA array hArray to the texture reference hTexRef. Any previous address or CUDA array state associated with the texture reference is superseded by this function. Flags must be set to CU_TRSA_OVERRIDE_FORMAT. Any CUDA array previously bound to hTexRef is unbound.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress(long[], jcuda.driver.CUtexref, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddress2D(jcuda.driver.CUtexref, jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddressMode(jcuda.driver.CUtexref, int, int), cuTexRefSetFilterMode(jcuda.driver.CUtexref, int), cuTexRefSetFlags(jcuda.driver.CUtexref, int), cuTexRefSetFormat(jcuda.driver.CUtexref, int, int), cuTexRefGetAddress(jcuda.driver.CUdeviceptr, jcuda.driver.CUtexref), cuTexRefGetAddressMode(int[], jcuda.driver.CUtexref, int), cuTexRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUtexref), cuTexRefGetFilterMode(int[], jcuda.driver.CUtexref), cuTexRefGetFlags(int[], jcuda.driver.CUtexref), cuTexRefGetFormat(int[], int[], jcuda.driver.CUtexref)

cuTexRefSetMipmappedArray

public static int cuTexRefSetMipmappedArray(CUtexref hTexRef,
                                            CUmipmappedArray hMipmappedArray,
                                            int Flags)

cuTexRefSetAddress

public static int cuTexRefSetAddress(long[] ByteOffset,
                                     CUtexref hTexRef,
                                     CUdeviceptr dptr,
                                     long bytes)
Binds an address as a texture reference.
CUresult cuTexRefSetAddress ( size_t *  ByteOffset,
CUtexref  hTexRef,
CUdeviceptr  dptr,
size_t  bytes  
)

Binds a linear address range to the texture reference hTexRef. Any previous address or CUDA array state associated with the texture reference is superseded by this function. Any memory previously bound to hTexRef is unbound.

Since the hardware enforces an alignment requirement on texture base addresses, cuTexRefSetAddress() passes back a byte offset in *ByteOffset that must be applied to texture fetches in order to read from the desired memory. This offset must be divided by the texel size and passed to kernels that read from the texture so they can be applied to the tex1Dfetch() function.

If the device memory pointer was returned from cuMemAlloc(), the offset is guaranteed to be 0 and NULL may be passed as the ByteOffset parameter.

The total number of elements (or texels) in the linear address range cannot exceed CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE1D_LINEAR_WIDTH. The number of elements is computed as (bytes / bytesPerElement), where bytesPerElement is determined from the data format and number of components set using cuTexRefSetFormat().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress2D(jcuda.driver.CUtexref, jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddressMode(jcuda.driver.CUtexref, int, int), cuTexRefSetArray(jcuda.driver.CUtexref, jcuda.driver.CUarray, int), cuTexRefSetFilterMode(jcuda.driver.CUtexref, int), cuTexRefSetFlags(jcuda.driver.CUtexref, int), cuTexRefSetFormat(jcuda.driver.CUtexref, int, int), cuTexRefGetAddress(jcuda.driver.CUdeviceptr, jcuda.driver.CUtexref), cuTexRefGetAddressMode(int[], jcuda.driver.CUtexref, int), cuTexRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUtexref), cuTexRefGetFilterMode(int[], jcuda.driver.CUtexref), cuTexRefGetFlags(int[], jcuda.driver.CUtexref), cuTexRefGetFormat(int[], int[], jcuda.driver.CUtexref)

cuTexRefSetFormat

public static int cuTexRefSetFormat(CUtexref hTexRef,
                                    int fmt,
                                    int NumPackedComponents)
Sets the format for a texture reference.
CUresult cuTexRefSetFormat ( CUtexref  hTexRef,
CUarray_format  fmt,
int  NumPackedComponents  
)

Specifies the format of the data to be read by the texture reference hTexRef. fmt and NumPackedComponents are exactly analogous to the Format and NumChannels members of the CUDA_ARRAY_DESCRIPTOR structure: They specify the format of each component and the number of components per array element.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress(long[], jcuda.driver.CUtexref, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddress2D(jcuda.driver.CUtexref, jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddressMode(jcuda.driver.CUtexref, int, int), cuTexRefSetArray(jcuda.driver.CUtexref, jcuda.driver.CUarray, int), cuTexRefSetFilterMode(jcuda.driver.CUtexref, int), cuTexRefSetFlags(jcuda.driver.CUtexref, int), cuTexRefGetAddress(jcuda.driver.CUdeviceptr, jcuda.driver.CUtexref), cuTexRefGetAddressMode(int[], jcuda.driver.CUtexref, int), cuTexRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUtexref), cuTexRefGetFilterMode(int[], jcuda.driver.CUtexref), cuTexRefGetFlags(int[], jcuda.driver.CUtexref), cuTexRefGetFormat(int[], int[], jcuda.driver.CUtexref)

cuTexRefSetAddress2D

public static int cuTexRefSetAddress2D(CUtexref hTexRef,
                                       CUDA_ARRAY_DESCRIPTOR desc,
                                       CUdeviceptr dptr,
                                       long PitchInBytes)
Binds an address as a 2D texture reference.
CUresult cuTexRefSetAddress2D ( CUtexref  hTexRef,
const CUDA_ARRAY_DESCRIPTOR *  desc,
CUdeviceptr  dptr,
size_t  Pitch  
)

Binds a linear address range to the texture reference hTexRef. Any previous address or CUDA array state associated with the texture reference is superseded by this function. Any memory previously bound to hTexRef is unbound.

Using a tex2D() function inside a kernel requires a call to either cuTexRefSetArray() to bind the corresponding texture reference to an array, or cuTexRefSetAddress2D() to bind the texture reference to linear memory.

Function calls to cuTexRefSetFormat() cannot follow calls to cuTexRefSetAddress2D() for the same texture reference.

It is required that dptr be aligned to the appropriate hardware-specific texture alignment. You can query this value using the device attribute CU_DEVICE_ATTRIBUTE_TEXTURE_ALIGNMENT. If an unaligned dptr is supplied, CUDA_ERROR_INVALID_VALUE is returned.

Pitch has to be aligned to the hardware-specific texture pitch alignment. This value can be queried using the device attribute CU_DEVICE_ATTRIBUTE_TEXTURE_PITCH_ALIGNMENT. If an unaligned Pitch is supplied, CUDA_ERROR_INVALID_VALUE is returned.

Width and Height, which are specified in elements (or texels), cannot exceed CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_WIDTH and CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_HEIGHT respectively. Pitch, which is specified in bytes, cannot exceed CU_DEVICE_ATTRIBUTE_MAXIMUM_TEXTURE2D_LINEAR_PITCH.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress(long[], jcuda.driver.CUtexref, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddressMode(jcuda.driver.CUtexref, int, int), cuTexRefSetArray(jcuda.driver.CUtexref, jcuda.driver.CUarray, int), cuTexRefSetFilterMode(jcuda.driver.CUtexref, int), cuTexRefSetFlags(jcuda.driver.CUtexref, int), cuTexRefSetFormat(jcuda.driver.CUtexref, int, int), cuTexRefGetAddress(jcuda.driver.CUdeviceptr, jcuda.driver.CUtexref), cuTexRefGetAddressMode(int[], jcuda.driver.CUtexref, int), cuTexRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUtexref), cuTexRefGetFilterMode(int[], jcuda.driver.CUtexref), cuTexRefGetFlags(int[], jcuda.driver.CUtexref), cuTexRefGetFormat(int[], int[], jcuda.driver.CUtexref)

cuTexRefSetAddressMode

public static int cuTexRefSetAddressMode(CUtexref hTexRef,
                                         int dim,
                                         int am)
Sets the addressing mode for a texture reference.
CUresult cuTexRefSetAddressMode ( CUtexref  hTexRef,
int  dim,
CUaddress_mode  am  
)

Specifies the addressing mode am for the given dimension dim of the texture reference hTexRef. If dim is zero, the addressing mode is applied to the first parameter of the functions used to fetch from the texture; if dim is 1, the second, and so on. CUaddress_mode is defined as:

   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;
 

Note that this call has no effect if hTexRef is bound to linear memory. Also, if the flag, CU_TRSF_NORMALIZED_COORDINATES, is not set, the only supported address mode is CU_TR_ADDRESS_MODE_CLAMP.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress(long[], jcuda.driver.CUtexref, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddress2D(jcuda.driver.CUtexref, jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUdeviceptr, long), cuTexRefSetArray(jcuda.driver.CUtexref, jcuda.driver.CUarray, int), cuTexRefSetFilterMode(jcuda.driver.CUtexref, int), cuTexRefSetFlags(jcuda.driver.CUtexref, int), cuTexRefSetFormat(jcuda.driver.CUtexref, int, int), cuTexRefGetAddress(jcuda.driver.CUdeviceptr, jcuda.driver.CUtexref), cuTexRefGetAddressMode(int[], jcuda.driver.CUtexref, int), cuTexRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUtexref), cuTexRefGetFilterMode(int[], jcuda.driver.CUtexref), cuTexRefGetFlags(int[], jcuda.driver.CUtexref), cuTexRefGetFormat(int[], int[], jcuda.driver.CUtexref)

cuTexRefSetFilterMode

public static int cuTexRefSetFilterMode(CUtexref hTexRef,
                                        int fm)
Sets the filtering mode for a texture reference.
CUresult cuTexRefSetFilterMode ( CUtexref  hTexRef,
CUfilter_mode  fm  
)

Specifies the filtering mode fm to be used when reading memory through the texture reference hTexRef. CUfilter_mode_enum is defined as:

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

Note that this call has no effect if hTexRef is bound to linear memory.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress(long[], jcuda.driver.CUtexref, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddress2D(jcuda.driver.CUtexref, jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddressMode(jcuda.driver.CUtexref, int, int), cuTexRefSetArray(jcuda.driver.CUtexref, jcuda.driver.CUarray, int), cuTexRefSetFlags(jcuda.driver.CUtexref, int), cuTexRefSetFormat(jcuda.driver.CUtexref, int, int), cuTexRefGetAddress(jcuda.driver.CUdeviceptr, jcuda.driver.CUtexref), cuTexRefGetAddressMode(int[], jcuda.driver.CUtexref, int), cuTexRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUtexref), cuTexRefGetFilterMode(int[], jcuda.driver.CUtexref), cuTexRefGetFlags(int[], jcuda.driver.CUtexref), cuTexRefGetFormat(int[], int[], jcuda.driver.CUtexref)

cuTexRefSetMipmapFilterMode

public static int cuTexRefSetMipmapFilterMode(CUtexref hTexRef,
                                              int fm)

cuTexRefSetMipmapLevelBias

public static int cuTexRefSetMipmapLevelBias(CUtexref hTexRef,
                                             float bias)

cuTexRefSetMipmapLevelClamp

public static int cuTexRefSetMipmapLevelClamp(CUtexref hTexRef,
                                              float minMipmapLevelClamp,
                                              float maxMipmapLevelClamp)

cuTexRefSetMaxAnisotropy

public static int cuTexRefSetMaxAnisotropy(CUtexref hTexRef,
                                           int maxAniso)

cuTexRefSetFlags

public static int cuTexRefSetFlags(CUtexref hTexRef,
                                   int Flags)
Sets the flags for a texture reference.
CUresult cuTexRefSetFlags ( CUtexref  hTexRef,
unsigned int  Flags  
)

Specifies optional flags via Flags to specify the behavior of data returned through the texture reference hTexRef. The valid flags are:

  • CU_TRSF_READ_AS_INTEGER, which suppresses the default behavior of having the texture promote integer data to floating point data in the range [0, 1]. Note that texture with 32-bit integer format would not be promoted, regardless of whether or not this flag is specified;
  • CU_TRSF_NORMALIZED_COORDINATES, which suppresses the default behavior of having the texture coordinates range from [0, Dim) where Dim is the width or height of the CUDA array. Instead, the texture coordinates [0, 1.0) reference the entire breadth of the array dimension;

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress(long[], jcuda.driver.CUtexref, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddress2D(jcuda.driver.CUtexref, jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddressMode(jcuda.driver.CUtexref, int, int), cuTexRefSetArray(jcuda.driver.CUtexref, jcuda.driver.CUarray, int), cuTexRefSetFilterMode(jcuda.driver.CUtexref, int), cuTexRefSetFormat(jcuda.driver.CUtexref, int, int), cuTexRefGetAddress(jcuda.driver.CUdeviceptr, jcuda.driver.CUtexref), cuTexRefGetAddressMode(int[], jcuda.driver.CUtexref, int), cuTexRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUtexref), cuTexRefGetFilterMode(int[], jcuda.driver.CUtexref), cuTexRefGetFlags(int[], jcuda.driver.CUtexref), cuTexRefGetFormat(int[], int[], jcuda.driver.CUtexref)

cuTexRefGetAddress

public static int cuTexRefGetAddress(CUdeviceptr pdptr,
                                     CUtexref hTexRef)
Gets the address associated with a texture reference.
CUresult cuTexRefGetAddress ( CUdeviceptr *  pdptr,
CUtexref  hTexRef  
)

Returns in *pdptr the base address bound to the texture reference hTexRef, or returns CUDA_ERROR_INVALID_VALUE if the texture reference is not bound to any device memory range.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress(long[], jcuda.driver.CUtexref, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddress2D(jcuda.driver.CUtexref, jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddressMode(jcuda.driver.CUtexref, int, int), cuTexRefSetArray(jcuda.driver.CUtexref, jcuda.driver.CUarray, int), cuTexRefSetFilterMode(jcuda.driver.CUtexref, int), cuTexRefSetFlags(jcuda.driver.CUtexref, int), cuTexRefSetFormat(jcuda.driver.CUtexref, int, int), cuTexRefGetAddressMode(int[], jcuda.driver.CUtexref, int), cuTexRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUtexref), cuTexRefGetFilterMode(int[], jcuda.driver.CUtexref), cuTexRefGetFlags(int[], jcuda.driver.CUtexref), cuTexRefGetFormat(int[], int[], jcuda.driver.CUtexref)

cuTexRefGetArray

public static int cuTexRefGetArray(CUarray phArray,
                                   CUtexref hTexRef)
Gets the array bound to a texture reference.
CUresult cuTexRefGetArray ( CUarray *  phArray,
CUtexref  hTexRef  
)

Returns in *phArray the CUDA array bound to the texture reference hTexRef, or returns CUDA_ERROR_INVALID_VALUE if the texture reference is not bound to any CUDA array.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress(long[], jcuda.driver.CUtexref, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddress2D(jcuda.driver.CUtexref, jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddressMode(jcuda.driver.CUtexref, int, int), cuTexRefSetArray(jcuda.driver.CUtexref, jcuda.driver.CUarray, int), cuTexRefSetFilterMode(jcuda.driver.CUtexref, int), cuTexRefSetFlags(jcuda.driver.CUtexref, int), cuTexRefSetFormat(jcuda.driver.CUtexref, int, int), cuTexRefGetAddress(jcuda.driver.CUdeviceptr, jcuda.driver.CUtexref), cuTexRefGetAddressMode(int[], jcuda.driver.CUtexref, int), cuTexRefGetFilterMode(int[], jcuda.driver.CUtexref), cuTexRefGetFlags(int[], jcuda.driver.CUtexref), cuTexRefGetFormat(int[], int[], jcuda.driver.CUtexref)

cuTexRefGetMipmappedArray

public static int cuTexRefGetMipmappedArray(CUmipmappedArray phMipmappedArray,
                                            CUtexref hTexRef)

cuTexRefGetAddressMode

public static int cuTexRefGetAddressMode(int[] pam,
                                         CUtexref hTexRef,
                                         int dim)
Gets the addressing mode used by a texture reference.
CUresult cuTexRefGetAddressMode ( CUaddress_mode *  pam,
CUtexref  hTexRef,
int  dim  
)

Returns in *pam the addressing mode corresponding to the dimension dim of the texture reference hTexRef. Currently, the only valid value for dim are 0 and 1.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress(long[], jcuda.driver.CUtexref, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddress2D(jcuda.driver.CUtexref, jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddressMode(jcuda.driver.CUtexref, int, int), cuTexRefSetArray(jcuda.driver.CUtexref, jcuda.driver.CUarray, int), cuTexRefSetFilterMode(jcuda.driver.CUtexref, int), cuTexRefSetFlags(jcuda.driver.CUtexref, int), cuTexRefSetFormat(jcuda.driver.CUtexref, int, int), cuTexRefGetAddress(jcuda.driver.CUdeviceptr, jcuda.driver.CUtexref), cuTexRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUtexref), cuTexRefGetFilterMode(int[], jcuda.driver.CUtexref), cuTexRefGetFlags(int[], jcuda.driver.CUtexref), cuTexRefGetFormat(int[], int[], jcuda.driver.CUtexref)

cuTexRefGetFilterMode

public static int cuTexRefGetFilterMode(int[] pfm,
                                        CUtexref hTexRef)
Gets the filter-mode used by a texture reference.
CUresult cuTexRefGetFilterMode ( CUfilter_mode *  pfm,
CUtexref  hTexRef  
)

Returns in *pfm the filtering mode of the texture reference hTexRef.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress(long[], jcuda.driver.CUtexref, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddress2D(jcuda.driver.CUtexref, jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddressMode(jcuda.driver.CUtexref, int, int), cuTexRefSetArray(jcuda.driver.CUtexref, jcuda.driver.CUarray, int), cuTexRefSetFilterMode(jcuda.driver.CUtexref, int), cuTexRefSetFlags(jcuda.driver.CUtexref, int), cuTexRefSetFormat(jcuda.driver.CUtexref, int, int), cuTexRefGetAddress(jcuda.driver.CUdeviceptr, jcuda.driver.CUtexref), cuTexRefGetAddressMode(int[], jcuda.driver.CUtexref, int), cuTexRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUtexref), cuTexRefGetFlags(int[], jcuda.driver.CUtexref), cuTexRefGetFormat(int[], int[], jcuda.driver.CUtexref)

cuTexRefGetFormat

public static int cuTexRefGetFormat(int[] pFormat,
                                    int[] pNumChannels,
                                    CUtexref hTexRef)
Gets the format used by a texture reference.
CUresult cuTexRefGetFormat ( CUarray_format *  pFormat,
int *  pNumChannels,
CUtexref  hTexRef  
)

Returns in *pFormat and *pNumChannels the format and number of components of the CUDA array bound to the texture reference hTexRef. If pFormat or pNumChannels is NULL, it will be ignored.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress(long[], jcuda.driver.CUtexref, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddress2D(jcuda.driver.CUtexref, jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddressMode(jcuda.driver.CUtexref, int, int), cuTexRefSetArray(jcuda.driver.CUtexref, jcuda.driver.CUarray, int), cuTexRefSetFilterMode(jcuda.driver.CUtexref, int), cuTexRefSetFlags(jcuda.driver.CUtexref, int), cuTexRefSetFormat(jcuda.driver.CUtexref, int, int), cuTexRefGetAddress(jcuda.driver.CUdeviceptr, jcuda.driver.CUtexref), cuTexRefGetAddressMode(int[], jcuda.driver.CUtexref, int), cuTexRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUtexref), cuTexRefGetFilterMode(int[], jcuda.driver.CUtexref), cuTexRefGetFlags(int[], jcuda.driver.CUtexref)

cuTexRefGetMipmapFilterMode

public static int cuTexRefGetMipmapFilterMode(int[] pfm,
                                              CUtexref hTexRef)

cuTexRefGetMipmapLevelBias

public static int cuTexRefGetMipmapLevelBias(float[] pbias,
                                             CUtexref hTexRef)

cuTexRefGetMipmapLevelClamp

public static int cuTexRefGetMipmapLevelClamp(float[] pminMipmapLevelClamp,
                                              float[] pmaxMipmapLevelClamp,
                                              CUtexref hTexRef)

cuTexRefGetMaxAnisotropy

public static int cuTexRefGetMaxAnisotropy(int[] pmaxAniso,
                                           CUtexref hTexRef)

cuTexRefGetFlags

public static int cuTexRefGetFlags(int[] pFlags,
                                   CUtexref hTexRef)
Gets the flags used by a texture reference.
CUresult cuTexRefGetFlags ( unsigned int *  pFlags,
CUtexref  hTexRef  
)

Returns in *pFlags the flags of the texture reference hTexRef.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuTexRefSetAddress(long[], jcuda.driver.CUtexref, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddress2D(jcuda.driver.CUtexref, jcuda.driver.CUDA_ARRAY_DESCRIPTOR, jcuda.driver.CUdeviceptr, long), cuTexRefSetAddressMode(jcuda.driver.CUtexref, int, int), cuTexRefSetArray(jcuda.driver.CUtexref, jcuda.driver.CUarray, int), cuTexRefSetFilterMode(jcuda.driver.CUtexref, int), cuTexRefSetFlags(jcuda.driver.CUtexref, int), cuTexRefSetFormat(jcuda.driver.CUtexref, int, int), cuTexRefGetAddress(jcuda.driver.CUdeviceptr, jcuda.driver.CUtexref), cuTexRefGetAddressMode(int[], jcuda.driver.CUtexref, int), cuTexRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUtexref), cuTexRefGetFilterMode(int[], jcuda.driver.CUtexref), cuTexRefGetFormat(int[], int[], jcuda.driver.CUtexref)

cuSurfRefSetArray

public static int cuSurfRefSetArray(CUsurfref hSurfRef,
                                    CUarray hArray,
                                    int Flags)
Sets the CUDA array for a surface reference.
CUresult cuSurfRefSetArray ( CUsurfref  hSurfRef,
CUarray  hArray,
unsigned int  Flags  
)

Sets the CUDA array hArray to be read and written by the surface reference hSurfRef. Any previous CUDA array state associated with the surface reference is superseded by this function. Flags must be set to 0. The CUDA_ARRAY3D_SURFACE_LDST flag must have been set for the CUDA array. Any CUDA array previously bound to hSurfRef is unbound.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuModuleGetSurfRef(jcuda.driver.CUsurfref, jcuda.driver.CUmodule, java.lang.String), cuSurfRefGetArray(jcuda.driver.CUarray, jcuda.driver.CUsurfref)

cuSurfRefGetArray

public static int cuSurfRefGetArray(CUarray phArray,
                                    CUsurfref hSurfRef)
Passes back the CUDA array bound to a surface reference.
CUresult cuSurfRefGetArray ( CUarray *  phArray,
CUsurfref  hSurfRef  
)

Returns in *phArray the CUDA array bound to the surface reference hSurfRef, or returns CUDA_ERROR_INVALID_VALUE if the surface reference is not bound to any CUDA array.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuModuleGetSurfRef(jcuda.driver.CUsurfref, jcuda.driver.CUmodule, java.lang.String), cuSurfRefSetArray(jcuda.driver.CUsurfref, jcuda.driver.CUarray, int)

cuTexObjectCreate

public static int cuTexObjectCreate(CUtexObject pTexObject,
                                    CUDA_RESOURCE_DESC pResDesc,
                                    CUDA_TEXTURE_DESC pTexDesc,
                                    CUDA_RESOURCE_VIEW_DESC pResViewDesc)

cuTexObjectDestroy

public static int cuTexObjectDestroy(CUtexObject texObject)

cuTexObjectGetResourceDesc

public static int cuTexObjectGetResourceDesc(CUDA_RESOURCE_DESC pResDesc,
                                             CUtexObject texObject)

cuTexObjectGetTextureDesc

public static int cuTexObjectGetTextureDesc(CUDA_TEXTURE_DESC pTexDesc,
                                            CUtexObject texObject)

cuTexObjectGetResourceViewDesc

public static int cuTexObjectGetResourceViewDesc(CUDA_RESOURCE_VIEW_DESC pResViewDesc,
                                                 CUtexObject texObject)

cuSurfObjectCreate

public static int cuSurfObjectCreate(CUsurfObject pSurfObject,
                                     CUDA_RESOURCE_DESC pResDesc)

cuSurfObjectDestroy

public static int cuSurfObjectDestroy(CUsurfObject surfObject)

cuSurfObjectGetResourceDesc

public static int cuSurfObjectGetResourceDesc(CUDA_RESOURCE_DESC pResDesc,
                                              CUsurfObject surfObject)

cuDeviceCanAccessPeer

public static int cuDeviceCanAccessPeer(int[] canAccessPeer,
                                        CUdevice dev,
                                        CUdevice peerDev)
Queries if a device may directly access a peer device's memory.
CUresult cuDeviceCanAccessPeer ( int *  canAccessPeer,
CUdevice  dev,
CUdevice  peerDev  
)

Returns in *canAccessPeer a value of 1 if contexts on dev are capable of directly accessing memory from contexts on peerDev and 0 otherwise. If direct access of peerDev from dev is possible, then access may be enabled on two specific contexts by calling cuCtxEnablePeerAccess().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_DEVICE
See Also:
cuCtxEnablePeerAccess(jcuda.driver.CUcontext, int), cuCtxDisablePeerAccess(jcuda.driver.CUcontext)

cuCtxEnablePeerAccess

public static int cuCtxEnablePeerAccess(CUcontext peerContext,
                                        int Flags)
Enables direct access to memory allocations in a peer context.
CUresult cuCtxEnablePeerAccess ( CUcontext  peerContext,
unsigned int  Flags  
)

If both the current context and peerContext are on devices which support unified addressing (as may be queried using CU_DEVICE_ATTRIBUTE_UNIFIED_ADDRESSING), then on success all allocations from peerContext will immediately be accessible by the current context. See Unified Addressing for additional details.

Note that access granted by this call is unidirectional and that in order to access memory from the current context in peerContext, a separate symmetric call to cuCtxEnablePeerAccess() is required.

Returns CUDA_ERROR_INVALID_DEVICE if cuDeviceCanAccessPeer() indicates that the CUdevice of the current context cannot directly access memory from the CUdevice of peerContext.

Returns CUDA_ERROR_PEER_ACCESS_ALREADY_ENABLED if direct access of peerContext from the current context has already been enabled.

Returns CUDA_ERROR_TOO_MANY_PEERS if direct peer access is not possible because hardware resources required for peer access have been exhausted.

Returns CUDA_ERROR_INVALID_CONTEXT if there is no current context, peerContext is not a valid context, or if the current context is peerContext.

Returns CUDA_ERROR_INVALID_VALUE if Flags is not 0.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_DEVICE, CUDA_ERROR_PEER_ACCESS_ALREADY_ENABLED, CUDA_ERROR_TOO_MANY_PEERS, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuDeviceCanAccessPeer(int[], jcuda.driver.CUdevice, jcuda.driver.CUdevice), cuCtxDisablePeerAccess(jcuda.driver.CUcontext)

cuCtxDisablePeerAccess

public static int cuCtxDisablePeerAccess(CUcontext peerContext)
Disables direct access to memory allocations in a peer context and unregisters any registered allocations.
CUresult cuCtxDisablePeerAccess ( CUcontext  peerContext  ) 

Returns CUDA_ERROR_PEER_ACCESS_NOT_ENABLED if direct peer access has not yet been enabled from peerContext to the current context.

Returns CUDA_ERROR_INVALID_CONTEXT if there is no current context, or if peerContext is not a valid context.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_PEER_ACCESS_NOT_ENABLED, CUDA_ERROR_INVALID_CONTEXT,
See Also:
cuDeviceCanAccessPeer(int[], jcuda.driver.CUdevice, jcuda.driver.CUdevice), cuCtxEnablePeerAccess(jcuda.driver.CUcontext, int)

cuParamSetSize

public static int cuParamSetSize(CUfunction hfunc,
                                 int numbytes)
Deprecated. This function is deprecated in the latest CUDA version

Sets the parameter size for the function.
CUresult cuParamSetSize ( CUfunction  hfunc,
unsigned int  numbytes  
)

Deprecated:
Sets through numbytes the total size in bytes needed by the function parameters of the kernel corresponding to hfunc.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuFuncSetBlockShape(jcuda.driver.CUfunction, int, int, int), cuFuncSetSharedSize(jcuda.driver.CUfunction, int), cuFuncGetAttribute(int[], int, jcuda.driver.CUfunction), cuParamSetf(jcuda.driver.CUfunction, int, float), cuParamSeti(jcuda.driver.CUfunction, int, int), cuParamSetv(jcuda.driver.CUfunction, int, jcuda.Pointer, int), cuLaunch(jcuda.driver.CUfunction), cuLaunchGrid(jcuda.driver.CUfunction, int, int), cuLaunchGridAsync(jcuda.driver.CUfunction, int, int, jcuda.driver.CUstream), cuLaunchKernel(jcuda.driver.CUfunction, int, int, int, int, int, int, int, jcuda.driver.CUstream, jcuda.Pointer, jcuda.Pointer)

cuParamSeti

public static int cuParamSeti(CUfunction hfunc,
                              int offset,
                              int value)
Deprecated. This function is deprecated in the latest CUDA version

Adds an integer parameter to the function's argument list.
CUresult cuParamSeti ( CUfunction  hfunc,
int  offset,
unsigned int  value  
)

Deprecated:
Sets an integer parameter that will be specified the next time the kernel corresponding to hfunc will be invoked. offset is a byte offset.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuFuncSetBlockShape(jcuda.driver.CUfunction, int, int, int), cuFuncSetSharedSize(jcuda.driver.CUfunction, int), cuFuncGetAttribute(int[], int, jcuda.driver.CUfunction), cuParamSetSize(jcuda.driver.CUfunction, int), cuParamSetf(jcuda.driver.CUfunction, int, float), cuParamSetv(jcuda.driver.CUfunction, int, jcuda.Pointer, int), cuLaunch(jcuda.driver.CUfunction), cuLaunchGrid(jcuda.driver.CUfunction, int, int), cuLaunchGridAsync(jcuda.driver.CUfunction, int, int, jcuda.driver.CUstream), cuLaunchKernel(jcuda.driver.CUfunction, int, int, int, int, int, int, int, jcuda.driver.CUstream, jcuda.Pointer, jcuda.Pointer)

cuParamSetf

public static int cuParamSetf(CUfunction hfunc,
                              int offset,
                              float value)
Deprecated. This function is deprecated in the latest CUDA version

Adds a floating-point parameter to the function's argument list.
CUresult cuParamSetf ( CUfunction  hfunc,
int  offset,
float  value  
)

Deprecated:
Sets a floating-point parameter that will be specified the next time the kernel corresponding to hfunc will be invoked. offset is a byte offset.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuFuncSetBlockShape(jcuda.driver.CUfunction, int, int, int), cuFuncSetSharedSize(jcuda.driver.CUfunction, int), cuFuncGetAttribute(int[], int, jcuda.driver.CUfunction), cuParamSetSize(jcuda.driver.CUfunction, int), cuParamSeti(jcuda.driver.CUfunction, int, int), cuParamSetv(jcuda.driver.CUfunction, int, jcuda.Pointer, int), cuLaunch(jcuda.driver.CUfunction), cuLaunchGrid(jcuda.driver.CUfunction, int, int), cuLaunchGridAsync(jcuda.driver.CUfunction, int, int, jcuda.driver.CUstream), cuLaunchKernel(jcuda.driver.CUfunction, int, int, int, int, int, int, int, jcuda.driver.CUstream, jcuda.Pointer, jcuda.Pointer)

cuParamSetv

public static int cuParamSetv(CUfunction hfunc,
                              int offset,
                              Pointer ptr,
                              int numbytes)
Deprecated. This function is deprecated in the latest CUDA version

Adds arbitrary data to the function's argument list.
CUresult cuParamSetv ( CUfunction  hfunc,
int  offset,
void *  ptr,
unsigned int  numbytes  
)

Deprecated:
Copies an arbitrary amount of data (specified in numbytes) from ptr into the parameter space of the kernel corresponding to hfunc. offset is a byte offset.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuFuncSetBlockShape(jcuda.driver.CUfunction, int, int, int), cuFuncSetSharedSize(jcuda.driver.CUfunction, int), cuFuncGetAttribute(int[], int, jcuda.driver.CUfunction), cuParamSetSize(jcuda.driver.CUfunction, int), cuParamSetf(jcuda.driver.CUfunction, int, float), cuParamSeti(jcuda.driver.CUfunction, int, int), cuLaunch(jcuda.driver.CUfunction), cuLaunchGrid(jcuda.driver.CUfunction, int, int), cuLaunchGridAsync(jcuda.driver.CUfunction, int, int, jcuda.driver.CUstream), cuLaunchKernel(jcuda.driver.CUfunction, int, int, int, int, int, int, int, jcuda.driver.CUstream, jcuda.Pointer, jcuda.Pointer)

cuParamSetTexRef

public static int cuParamSetTexRef(CUfunction hfunc,
                                   int texunit,
                                   CUtexref hTexRef)
Deprecated. This function is deprecated in the latest CUDA version

Adds a texture-reference to the function's argument list.
CUresult cuParamSetTexRef ( CUfunction  hfunc,
int  texunit,
CUtexref  hTexRef  
)

Deprecated:
Makes the CUDA array or linear memory bound to the texture reference hTexRef available to a device program as a texture. In this version of CUDA, the texture-reference must be obtained via cuModuleGetTexRef() and the texunit parameter must be set to CU_PARAM_TR_DEFAULT.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE

cuLaunch

public static int cuLaunch(CUfunction f)
Deprecated. This function is deprecated in the latest CUDA version

Launches a CUDA function.
CUresult cuLaunch ( CUfunction  f  ) 

Deprecated:
Invokes the kernel f on a 1 x 1 x 1 grid of blocks. The block contains the number of threads specified by a previous call to cuFuncSetBlockShape().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_LAUNCH_FAILED, CUDA_ERROR_LAUNCH_OUT_OF_RESOURCES, CUDA_ERROR_LAUNCH_TIMEOUT, CUDA_ERROR_LAUNCH_INCOMPATIBLE_TEXTURING, CUDA_ERROR_SHARED_OBJECT_INIT_FAILED
See Also:
cuFuncSetBlockShape(jcuda.driver.CUfunction, int, int, int), cuFuncSetSharedSize(jcuda.driver.CUfunction, int), cuFuncGetAttribute(int[], int, jcuda.driver.CUfunction), cuParamSetSize(jcuda.driver.CUfunction, int), cuParamSetf(jcuda.driver.CUfunction, int, float), cuParamSeti(jcuda.driver.CUfunction, int, int), cuParamSetv(jcuda.driver.CUfunction, int, jcuda.Pointer, int), cuLaunchGrid(jcuda.driver.CUfunction, int, int), cuLaunchGridAsync(jcuda.driver.CUfunction, int, int, jcuda.driver.CUstream), cuLaunchKernel(jcuda.driver.CUfunction, int, int, int, int, int, int, int, jcuda.driver.CUstream, jcuda.Pointer, jcuda.Pointer)

cuLaunchGrid

public static int cuLaunchGrid(CUfunction f,
                               int grid_width,
                               int grid_height)
Deprecated. This function is deprecated in the latest CUDA version

Launches a CUDA function.
CUresult cuLaunchGrid ( CUfunction  f,
int  grid_width,
int  grid_height  
)

Deprecated:
Invokes the kernel f on a grid_width x grid_height grid of blocks. Each block contains the number of threads specified by a previous call to cuFuncSetBlockShape().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_LAUNCH_FAILED, CUDA_ERROR_LAUNCH_OUT_OF_RESOURCES, CUDA_ERROR_LAUNCH_TIMEOUT, CUDA_ERROR_LAUNCH_INCOMPATIBLE_TEXTURING, CUDA_ERROR_SHARED_OBJECT_INIT_FAILED
See Also:
cuFuncSetBlockShape(jcuda.driver.CUfunction, int, int, int), cuFuncSetSharedSize(jcuda.driver.CUfunction, int), cuFuncGetAttribute(int[], int, jcuda.driver.CUfunction), cuParamSetSize(jcuda.driver.CUfunction, int), cuParamSetf(jcuda.driver.CUfunction, int, float), cuParamSeti(jcuda.driver.CUfunction, int, int), cuParamSetv(jcuda.driver.CUfunction, int, jcuda.Pointer, int), cuLaunch(jcuda.driver.CUfunction), cuLaunchGridAsync(jcuda.driver.CUfunction, int, int, jcuda.driver.CUstream), cuLaunchKernel(jcuda.driver.CUfunction, int, int, int, int, int, int, int, jcuda.driver.CUstream, jcuda.Pointer, jcuda.Pointer)

cuLaunchGridAsync

public static int cuLaunchGridAsync(CUfunction f,
                                    int grid_width,
                                    int grid_height,
                                    CUstream hStream)
Deprecated. This function is deprecated in the latest CUDA version

Launches a CUDA function.
CUresult cuLaunchGridAsync ( CUfunction  f,
int  grid_width,
int  grid_height,
CUstream  hStream  
)

Deprecated:
Invokes the kernel f on a grid_width x grid_height grid of blocks. Each block contains the number of threads specified by a previous call to cuFuncSetBlockShape().

cuLaunchGridAsync() can optionally be associated to a stream by passing a non-zero hStream argument.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_LAUNCH_FAILED, CUDA_ERROR_LAUNCH_OUT_OF_RESOURCES, CUDA_ERROR_LAUNCH_TIMEOUT, CUDA_ERROR_LAUNCH_INCOMPATIBLE_TEXTURING, CUDA_ERROR_SHARED_OBJECT_INIT_FAILED
See Also:
cuFuncSetBlockShape(jcuda.driver.CUfunction, int, int, int), cuFuncSetSharedSize(jcuda.driver.CUfunction, int), cuFuncGetAttribute(int[], int, jcuda.driver.CUfunction), cuParamSetSize(jcuda.driver.CUfunction, int), cuParamSetf(jcuda.driver.CUfunction, int, float), cuParamSeti(jcuda.driver.CUfunction, int, int), cuParamSetv(jcuda.driver.CUfunction, int, jcuda.Pointer, int), cuLaunch(jcuda.driver.CUfunction), cuLaunchGrid(jcuda.driver.CUfunction, int, int), cuLaunchKernel(jcuda.driver.CUfunction, int, int, int, int, int, int, int, jcuda.driver.CUstream, jcuda.Pointer, jcuda.Pointer)

cuEventCreate

public static int cuEventCreate(CUevent phEvent,
                                int Flags)
Creates an event.
CUresult cuEventCreate ( CUevent *  phEvent,
unsigned int  Flags  
)

Creates an event *phEvent with the flags specified via Flags. Valid flags include:

  • CU_EVENT_DEFAULT: Default event creation flag.
  • CU_EVENT_BLOCKING_SYNC: Specifies that the created event should use blocking synchronization. A CPU thread that uses cuEventSynchronize() to wait on an event created with this flag will block until the event has actually been recorded.
  • CU_EVENT_DISABLE_TIMING: Specifies that the created event does not need to record timing data. Events created with this flag specified and the CU_EVENT_BLOCKING_SYNC flag not specified will provide the best performance when used with cuStreamWaitEvent() and cuEventQuery().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY
See Also:
cuEventRecord(jcuda.driver.CUevent, jcuda.driver.CUstream), cuEventQuery(jcuda.driver.CUevent), cuEventSynchronize(jcuda.driver.CUevent), cuEventDestroy(jcuda.driver.CUevent), cuEventElapsedTime(float[], jcuda.driver.CUevent, jcuda.driver.CUevent)

cuEventRecord

public static int cuEventRecord(CUevent hEvent,
                                CUstream hStream)
Records an event.
CUresult cuEventRecord ( CUevent  hEvent,
CUstream  hStream  
)

Records an event. If hStream is non-zero, the event is recorded after all preceding operations in hStream have been completed; otherwise, it is recorded after all preceding operations in the CUDA context have been completed. Since operation is asynchronous, cuEventQuery and/or cuEventSynchronize() must be used to determine when the event has actually been recorded.

If cuEventRecord() has previously been called on hEvent, then this call will overwrite any existing state in hEvent. Any subsequent calls which examine the status of hEvent will only examine the completion of this most recent call to cuEventRecord().

It is necessary that hEvent and hStream be created on the same context.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_INVALID_VALUE
See Also:
cuEventCreate(jcuda.driver.CUevent, int), cuEventQuery(jcuda.driver.CUevent), cuEventSynchronize(jcuda.driver.CUevent), cuStreamWaitEvent(jcuda.driver.CUstream, jcuda.driver.CUevent, int), cuEventDestroy(jcuda.driver.CUevent), cuEventElapsedTime(float[], jcuda.driver.CUevent, jcuda.driver.CUevent)

cuEventQuery

public static int cuEventQuery(CUevent hEvent)
Queries an event's status.
CUresult cuEventQuery ( CUevent  hEvent  ) 

Query the status of all device work preceding the most recent call to cuEventRecord() (in the appropriate compute streams, as specified by the arguments to cuEventRecord()).

If this work has successfully been completed by the device, or if cuEventRecord() has not been called on hEvent, then CUDA_SUCCESS is returned. If this work has not yet been completed by the device then CUDA_ERROR_NOT_READY is returned.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_NOT_READY
See Also:
cuEventCreate(jcuda.driver.CUevent, int), cuEventRecord(jcuda.driver.CUevent, jcuda.driver.CUstream), cuEventSynchronize(jcuda.driver.CUevent), cuEventDestroy(jcuda.driver.CUevent), cuEventElapsedTime(float[], jcuda.driver.CUevent, jcuda.driver.CUevent)

cuEventSynchronize

public static int cuEventSynchronize(CUevent hEvent)
Waits for an event to complete.
CUresult cuEventSynchronize ( CUevent  hEvent  ) 

Wait until the completion of all device work preceding the most recent call to cuEventRecord() (in the appropriate compute streams, as specified by the arguments to cuEventRecord()).

If cuEventRecord() has not been called on hEvent, CUDA_SUCCESS is returned immediately.

Waiting for an event that was created with the CU_EVENT_BLOCKING_SYNC flag will cause the calling CPU thread to block until the event has been completed by the device. If the CU_EVENT_BLOCKING_SYNC flag has not been set, then the CPU thread will busy-wait until the event has been completed by the device.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE
See Also:
cuEventCreate(jcuda.driver.CUevent, int), cuEventRecord(jcuda.driver.CUevent, jcuda.driver.CUstream), cuEventQuery(jcuda.driver.CUevent), cuEventDestroy(jcuda.driver.CUevent), cuEventElapsedTime(float[], jcuda.driver.CUevent, jcuda.driver.CUevent)

cuEventDestroy

public static int cuEventDestroy(CUevent hEvent)
Destroys an event.
CUresult cuEventDestroy ( CUevent  hEvent  ) 

Destroys the event specified by hEvent.

In the case that hEvent has been recorded but has not yet been completed when cuEventDestroy() is called, the function will return immediately and the resources associated with hEvent will be released automatically once the device has completed hEvent.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE
See Also:
cuEventCreate(jcuda.driver.CUevent, int), cuEventRecord(jcuda.driver.CUevent, jcuda.driver.CUstream), cuEventQuery(jcuda.driver.CUevent), cuEventSynchronize(jcuda.driver.CUevent), cuEventElapsedTime(float[], jcuda.driver.CUevent, jcuda.driver.CUevent)

cuEventElapsedTime

public static int cuEventElapsedTime(float[] pMilliseconds,
                                     CUevent hStart,
                                     CUevent hEnd)
Computes the elapsed time between two events.
CUresult cuEventElapsedTime ( float *  pMilliseconds,
CUevent  hStart,
CUevent  hEnd  
)

Computes the elapsed time between two events (in milliseconds with a resolution of around 0.5 microseconds).

If either event was last recorded in a non-NULL stream, the resulting time may be greater than expected (even if both used the same stream handle). This happens because the cuEventRecord() operation takes place asynchronously and there is no guarantee that the measured latency is actually just between the two events. Any number of other different stream operations could execute in between the two measured events, thus altering the timing in a significant way.

If cuEventRecord() has not been called on either event then CUDA_ERROR_INVALID_HANDLE is returned. If cuEventRecord() has been called on both events but one or both of them has not yet been completed (that is, cuEventQuery() would return CUDA_ERROR_NOT_READY on at least one of the events), CUDA_ERROR_NOT_READY is returned. If either event was created with the CU_EVENT_DISABLE_TIMING flag, then this function will return CUDA_ERROR_INVALID_HANDLE.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_READY
See Also:
cuEventCreate(jcuda.driver.CUevent, int), cuEventRecord(jcuda.driver.CUevent, jcuda.driver.CUstream), cuEventQuery(jcuda.driver.CUevent), cuEventSynchronize(jcuda.driver.CUevent), cuEventDestroy(jcuda.driver.CUevent)

cuPointerGetAttribute

public static int cuPointerGetAttribute(Pointer data,
                                        int attribute,
                                        CUdeviceptr ptr)
Returns information about a pointer.
CUresult cuPointerGetAttribute ( void *  data,
CUpointer_attribute  attribute,
CUdeviceptr  ptr  
)

The supported attributes are:

  • CU_POINTER_ATTRIBUTE_CONTEXT:

Returns in *data the CUcontext in which ptr was allocated or registered. The type of data must be CUcontext *.

If ptr was not allocated by, mapped by, or registered with a CUcontext which uses unified virtual addressing then CUDA_ERROR_INVALID_VALUE is returned.

  • CU_POINTER_ATTRIBUTE_MEMORY_TYPE:

Returns in *data the physical memory type of the memory that ptr addresses as a CUmemorytype enumerated value. The type of data must be unsigned int.

If ptr addresses device memory then *data is set to CU_MEMORYTYPE_DEVICE. The particular CUdevice on which the memory resides is the CUdevice of the CUcontext returned by the CU_POINTER_ATTRIBUTE_CONTEXT attribute of ptr.

If ptr addresses host memory then *data is set to CU_MEMORYTYPE_HOST.

If ptr was not allocated by, mapped by, or registered with a CUcontext which uses unified virtual addressing then CUDA_ERROR_INVALID_VALUE is returned.

If the current CUcontext does not support unified virtual addressing then CUDA_ERROR_INVALID_CONTEXT is returned.

  • CU_POINTER_ATTRIBUTE_DEVICE_POINTER:

Returns in *data the device pointer value through which ptr may be accessed by kernels running in the current CUcontext. The type of data must be CUdeviceptr *.

If there exists no device pointer value through which kernels running in the current CUcontext may access ptr then CUDA_ERROR_INVALID_VALUE is returned.

If there is no current CUcontext then CUDA_ERROR_INVALID_CONTEXT is returned.

Except in the exceptional disjoint addressing cases discussed below, the value returned in *data will equal the input value ptr.

  • CU_POINTER_ATTRIBUTE_HOST_POINTER:

Returns in *data the host pointer value through which ptr may be accessed by by the host program. The type of data must be void **. If there exists no host pointer value through which the host program may directly access ptr then CUDA_ERROR_INVALID_VALUE is returned.

Except in the exceptional disjoint addressing cases discussed below, the value returned in *data will equal the input value ptr.

Note that for most allocations in the unified virtual address space the host and device pointer for accessing the allocation will be the same. The exceptions to this are
  • user memory registered using cuMemHostRegister
  • host memory allocated using cuMemHostAlloc with the CU_MEMHOSTALLOC_WRITECOMBINED flag For these types of allocation there will exist separate, disjoint host and device addresses for accessing the allocation. In particular
  • The host address will correspond to an invalid unmapped device address (which will result in an exception if accessed from the device)
  • The device address will correspond to an invalid unmapped host address (which will result in an exception if accessed from the host). For these types of allocations, querying CU_POINTER_ATTRIBUTE_HOST_POINTER and CU_POINTER_ATTRIBUTE_DEVICE_POINTER may be used to retrieve the host and device addresses from either address.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_DEVICE
See Also:
cuMemAlloc(jcuda.driver.CUdeviceptr, long), cuMemFree(jcuda.driver.CUdeviceptr), cuMemAllocHost(jcuda.Pointer, long), cuMemFreeHost(jcuda.Pointer), cuMemHostAlloc(jcuda.Pointer, long, int), cuMemHostRegister(jcuda.Pointer, long, int), cuMemHostUnregister(jcuda.Pointer)

cuStreamCreate

public static int cuStreamCreate(CUstream phStream,
                                 int Flags)
Create a stream.
CUresult cuStreamCreate ( CUstream *  phStream,
unsigned int  Flags  
)

Creates a stream and returns a handle in phStream. Flags is required to be 0.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY
See Also:
cuStreamDestroy(jcuda.driver.CUstream), cuStreamWaitEvent(jcuda.driver.CUstream, jcuda.driver.CUevent, int), cuStreamQuery(jcuda.driver.CUstream), cuStreamSynchronize(jcuda.driver.CUstream)

cuStreamWaitEvent

public static int cuStreamWaitEvent(CUstream hStream,
                                    CUevent hEvent,
                                    int Flags)
Make a compute stream wait on an event.
CUresult cuStreamWaitEvent ( CUstream  hStream,
CUevent  hEvent,
unsigned int  Flags  
)

Makes all future work submitted to hStream wait until hEvent reports completion before beginning execution. This synchronization will be performed efficiently on the device. The event hEvent may be from a different context than hStream, in which case this function will perform cross-device synchronization.

The stream hStream will wait only for the completion of the most recent host call to cuEventRecord() on hEvent. Once this call has returned, any functions (including cuEventRecord() and cuEventDestroy()) may be called on hEvent again, and the subsequent calls will not have any effect on hStream.

If hStream is 0 (the NULL stream) any future work submitted in any stream will wait for hEvent to complete before beginning execution. This effectively creates a barrier for all future work submitted to the context.

If cuEventRecord() has not been called on hEvent, this call acts as if the record has already completed, and so is a functional no-op.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE,
See Also:
cuStreamCreate(jcuda.driver.CUstream, int), cuEventRecord(jcuda.driver.CUevent, jcuda.driver.CUstream), cuStreamQuery(jcuda.driver.CUstream), cuStreamSynchronize(jcuda.driver.CUstream), cuStreamDestroy(jcuda.driver.CUstream)

cuStreamAddCallback

public static int cuStreamAddCallback(CUstream hStream,
                                      CUstreamCallback callback,
                                      java.lang.Object userData,
                                      int flags)

cuStreamQuery

public static int cuStreamQuery(CUstream hStream)
Determine status of a compute stream.
CUresult cuStreamQuery ( CUstream  hStream  ) 

Returns CUDA_SUCCESS if all operations in the stream specified by hStream have completed, or CUDA_ERROR_NOT_READY if not.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_READY
See Also:
cuStreamCreate(jcuda.driver.CUstream, int), cuStreamWaitEvent(jcuda.driver.CUstream, jcuda.driver.CUevent, int), cuStreamDestroy(jcuda.driver.CUstream), cuStreamSynchronize(jcuda.driver.CUstream)

cuStreamSynchronize

public static int cuStreamSynchronize(CUstream hStream)
Wait until a stream's tasks are completed.
CUresult cuStreamSynchronize ( CUstream  hStream  ) 

Waits until the device has completed all operations in the stream specified by hStream. If the context was created with the CU_CTX_SCHED_BLOCKING_SYNC flag, the CPU thread will block until the stream is finished with all of its tasks.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE
See Also:
cuStreamCreate(jcuda.driver.CUstream, int), cuStreamDestroy(jcuda.driver.CUstream), cuStreamWaitEvent(jcuda.driver.CUstream, jcuda.driver.CUevent, int), cuStreamQuery(jcuda.driver.CUstream)

cuStreamDestroy

public static int cuStreamDestroy(CUstream hStream)
Destroys a stream.
CUresult cuStreamDestroy ( CUstream  hStream  ) 

Destroys the stream specified by hStream.

In the case that the device is still doing work in the stream hStream when cuStreamDestroy() is called, the function will return immediately and the resources associated with hStream will be released automatically once the device has completed all work in hStream.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuStreamCreate(jcuda.driver.CUstream, int), cuStreamWaitEvent(jcuda.driver.CUstream, jcuda.driver.CUevent, int), cuStreamQuery(jcuda.driver.CUstream), cuStreamSynchronize(jcuda.driver.CUstream)

cuGLInit

public static int cuGLInit()
Deprecated. This function is deprecated in the latest CUDA version

Initializes OpenGL interoperability.
CUresult cuGLInit ( void   ) 

Deprecated:
This function is deprecated as of Cuda 3.0.
Initializes OpenGL interoperability. This function is deprecated and calling it is no longer required. It may fail if the needed OpenGL driver facilities are not available.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_UNKNOWN
See Also:
cuGLCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuGLMapBufferObject(jcuda.driver.CUdeviceptr, long[], int), cuGLRegisterBufferObject(int), cuGLUnmapBufferObject(int), cuGLUnregisterBufferObject(int), cuGLMapBufferObjectAsync(jcuda.driver.CUdeviceptr, long[], int, jcuda.driver.CUstream), cuGLUnmapBufferObjectAsync(int, jcuda.driver.CUstream), cuGLSetBufferObjectMapFlags(int, int)

cuGLCtxCreate

public static int cuGLCtxCreate(CUcontext pCtx,
                                int Flags,
                                CUdevice device)
Create a CUDA context for interoperability with OpenGL.
CUresult cuGLCtxCreate ( CUcontext *  pCtx,
unsigned int  Flags,
CUdevice  device  
)

Creates a new CUDA context, initializes OpenGL interoperability, and associates the CUDA context with the calling thread. It must be called before performing any other OpenGL interoperability operations. It may fail if the needed OpenGL driver facilities are not available. For usage of the Flags parameter, see cuCtxCreate().

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_OUT_OF_MEMORY
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuGLInit(), cuGLMapBufferObject(jcuda.driver.CUdeviceptr, long[], int), cuGLRegisterBufferObject(int), cuGLUnmapBufferObject(int), cuGLUnregisterBufferObject(int), cuGLMapBufferObjectAsync(jcuda.driver.CUdeviceptr, long[], int, jcuda.driver.CUstream), cuGLUnmapBufferObjectAsync(int, jcuda.driver.CUstream), cuGLSetBufferObjectMapFlags(int, int)

cuGLGetDevices

public static int cuGLGetDevices(int[] pCudaDeviceCount,
                                 CUdevice[] pCudaDevices,
                                 int cudaDeviceCount,
                                 int CUGLDeviceList_deviceList)
Gets the CUDA devices associated with the current OpenGL context.
CUresult cuGLGetDevices ( unsigned int *  pCudaDeviceCount,
CUdevice *  pCudaDevices,
unsigned int  cudaDeviceCount,
CUGLDeviceList  deviceList  
)

Returns in *pCudaDeviceCount the number of CUDA-compatible devices corresponding to the current OpenGL context. Also returns in *pCudaDevices at most cudaDeviceCount of the CUDA-compatible devices corresponding to the current OpenGL context. If any of the GPUs being used by the current OpenGL context are not CUDA capable then the call will return CUDA_ERROR_NO_DEVICE.

The deviceList argument may be any of the following:

  • CU_GL_DEVICE_LIST_ALL: Query all devices used by the current OpenGL context.
  • CU_GL_DEVICE_LIST_CURRENT_FRAME: Query the devices used by the current OpenGL context to render the current frame (in SLI).
  • CU_GL_DEVICE_LIST_NEXT_FRAME: Query the devices used by the current OpenGL context to render the next frame (in SLI). Note that this is a prediction, it can't be guaranteed that this is correct in all cases.

Returns:
CUDA_SUCCESS, CUDA_ERROR_NO_DEVICE, CUDA_ERROR_INVALID_VALUE CUDA_ERROR_INVALID_CONTEXT
See Also:
cuGLCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuGLInit()

cuGraphicsGLRegisterBuffer

public static int cuGraphicsGLRegisterBuffer(CUgraphicsResource pCudaResource,
                                             int buffer,
                                             int Flags)
Registers an OpenGL buffer object.
CUresult cuGraphicsGLRegisterBuffer ( CUgraphicsResource *  pCudaResource,
GLuint  buffer,
unsigned int  Flags  
)

Registers the buffer object specified by buffer for access by CUDA. A handle to the registered object is returned as pCudaResource. The register flags Flags specify the intended usage, as follows:

  • CU_GRAPHICS_REGISTER_FLAGS_NONE: Specifies no hints about how this resource will be used. It is therefore assumed that this resource will be read from and written to by CUDA. This is the default value.
  • CU_GRAPHICS_REGISTER_FLAGS_READ_ONLY: Specifies that CUDA will not write to this resource.
  • CU_GRAPHICS_REGISTER_FLAGS_WRITE_DISCARD: Specifies that CUDA will not read from this resource and will write over the entire contents of the resource, so none of the data previously stored in the resource will be preserved.

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_ALREADY_MAPPED, CUDA_ERROR_INVALID_CONTEXT,
See Also:
cuGLCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuGraphicsUnregisterResource(jcuda.driver.CUgraphicsResource), cuGraphicsMapResources(int, jcuda.driver.CUgraphicsResource[], jcuda.driver.CUstream), cuGraphicsResourceGetMappedPointer(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUgraphicsResource)

cuGraphicsGLRegisterImage

public static int cuGraphicsGLRegisterImage(CUgraphicsResource pCudaResource,
                                            int image,
                                            int target,
                                            int Flags)
Register an OpenGL texture or renderbuffer object.
CUresult cuGraphicsGLRegisterImage ( CUgraphicsResource *  pCudaResource,
GLuint  image,
GLenum  target,
unsigned int  Flags  
)

Registers the texture or renderbuffer object specified by image for access by CUDA. A handle to the registered object is returned as pCudaResource.

target must match the type of the object, and must be one of GL_TEXTURE_2D, GL_TEXTURE_RECTANGLE, GL_TEXTURE_CUBE_MAP, GL_TEXTURE_3D, GL_TEXTURE_2D_ARRAY, or GL_RENDERBUFFER.

The register flags Flags specify the intended usage, as follows:

  • CU_GRAPHICS_REGISTER_FLAGS_NONE: Specifies no hints about how this resource will be used. It is therefore assumed that this resource will be read from and written to by CUDA. This is the default value.
  • CU_GRAPHICS_REGISTER_FLAGS_READ_ONLY: Specifies that CUDA will not write to this resource.
  • CU_GRAPHICS_REGISTER_FLAGS_WRITE_DISCARD: Specifies that CUDA will not read from this resource and will write over the entire contents of the resource, so none of the data previously stored in the resource will be preserved.
  • CU_GRAPHICS_REGISTER_FLAGS_SURFACE_LDST: Specifies that CUDA will bind this resource to a surface reference.
  • CU_GRAPHICS_REGISTER_FLAGS_TEXTURE_GATHER: Specifies that CUDA will perform texture gather operations on this resource.

The following image formats are supported. For brevity's sake, the list is abbreviated. For ex., {GL_R, GL_RG} X {8, 16} would expand to the following 4 formats {GL_R8, GL_R16, GL_RG8, GL_RG16} :

  • GL_RED, GL_RG, GL_RGBA, GL_LUMINANCE, GL_ALPHA, GL_LUMINANCE_ALPHA, GL_INTENSITY
  • {GL_R, GL_RG, GL_RGBA} X {8, 16, 16F, 32F, 8UI, 16UI, 32UI, 8I, 16I, 32I}
  • {GL_LUMINANCE, GL_ALPHA, GL_LUMINANCE_ALPHA, GL_INTENSITY} X {8, 16, 16F_ARB, 32F_ARB, 8UI_EXT, 16UI_EXT, 32UI_EXT, 8I_EXT, 16I_EXT, 32I_EXT}

The following image classes are currently disallowed:

  • Textures with borders
  • Multisampled renderbuffers

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_ALREADY_MAPPED, CUDA_ERROR_INVALID_CONTEXT,
See Also:
cuGLCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuGraphicsUnregisterResource(jcuda.driver.CUgraphicsResource), cuGraphicsMapResources(int, jcuda.driver.CUgraphicsResource[], jcuda.driver.CUstream), cuGraphicsSubResourceGetMappedArray(jcuda.driver.CUarray, jcuda.driver.CUgraphicsResource, int, int)

cuGLRegisterBufferObject

public static int cuGLRegisterBufferObject(int bufferobj)
Deprecated. This function is deprecated in the latest CUDA version

Registers an OpenGL buffer object.
CUresult cuGLRegisterBufferObject ( GLuint  buffer  ) 

Deprecated:
This function is deprecated as of Cuda 3.0.
Registers the buffer object specified by buffer for access by CUDA. This function must be called before CUDA can map the buffer object. There must be a valid OpenGL context bound to the current thread when this function is called, and the buffer name is resolved by that context.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_ALREADY_MAPPED
See Also:
cuGraphicsGLRegisterBuffer(jcuda.driver.CUgraphicsResource, int, int)

cuGLMapBufferObject

public static int cuGLMapBufferObject(CUdeviceptr dptr,
                                      long[] size,
                                      int bufferobj)
Deprecated. This function is deprecated in the latest CUDA version

Maps an OpenGL buffer object.
CUresult cuGLMapBufferObject ( CUdeviceptr *  dptr,
size_t *  size,
GLuint  buffer  
)

Deprecated:
This function is deprecated as of Cuda 3.0.
Maps the buffer object specified by buffer into the address space of the current CUDA context and returns in *dptr and *size the base pointer and size of the resulting mapping.

There must be a valid OpenGL context bound to the current thread when this function is called. This must be the same context, or a member of the same shareGroup, as the context that was bound when the buffer was registered.

All streams in the current CUDA context are synchronized with the current GL context.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_MAP_FAILED
See Also:
cuGraphicsMapResources(int, jcuda.driver.CUgraphicsResource[], jcuda.driver.CUstream)

cuGLUnmapBufferObject

public static int cuGLUnmapBufferObject(int bufferobj)
Deprecated. This function is deprecated in the latest CUDA version

Unmaps an OpenGL buffer object.
CUresult cuGLUnmapBufferObject ( GLuint  buffer  ) 

Deprecated:
This function is deprecated as of Cuda 3.0.
Unmaps the buffer object specified by buffer for access by CUDA.

There must be a valid OpenGL context bound to the current thread when this function is called. This must be the same context, or a member of the same shareGroup, as the context that was bound when the buffer was registered.

All streams in the current CUDA context are synchronized with the current GL context.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuGraphicsUnmapResources(int, jcuda.driver.CUgraphicsResource[], jcuda.driver.CUstream)

cuGLUnregisterBufferObject

public static int cuGLUnregisterBufferObject(int bufferobj)
Deprecated. This function is deprecated in the latest CUDA version

Unregister an OpenGL buffer object.
CUresult cuGLUnregisterBufferObject ( GLuint  buffer  ) 

Deprecated:
This function is deprecated as of Cuda 3.0.
Unregisters the buffer object specified by buffer. This releases any resources associated with the registered buffer. After this call, the buffer may no longer be mapped for access by CUDA.

There must be a valid OpenGL context bound to the current thread when this function is called. This must be the same context, or a member of the same shareGroup, as the context that was bound when the buffer was registered.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuGraphicsUnregisterResource(jcuda.driver.CUgraphicsResource)

cuGLSetBufferObjectMapFlags

public static int cuGLSetBufferObjectMapFlags(int buffer,
                                              int Flags)
Deprecated. This function is deprecated in the latest CUDA version

Set the map flags for an OpenGL buffer object.
CUresult cuGLSetBufferObjectMapFlags ( GLuint  buffer,
unsigned int  Flags  
)

Deprecated:
This function is deprecated as of Cuda 3.0.
Sets the map flags for the buffer object specified by buffer.

Changes to Flags will take effect the next time buffer is mapped. The Flags argument may be any of the following:

  • CU_GL_MAP_RESOURCE_FLAGS_NONE: Specifies no hints about how this resource will be used. It is therefore assumed that this resource will be read from and written to by CUDA kernels. This is the default value.
  • CU_GL_MAP_RESOURCE_FLAGS_READ_ONLY: Specifies that CUDA kernels which access this resource will not write to this resource.
  • CU_GL_MAP_RESOURCE_FLAGS_WRITE_DISCARD: Specifies that CUDA kernels which access this resource will not read from this resource and will write over the entire contents of the resource, so none of the data previously stored in the resource will be preserved.

If buffer has not been registered for use with CUDA, then CUDA_ERROR_INVALID_HANDLE is returned. If buffer is presently mapped for access by CUDA, then CUDA_ERROR_ALREADY_MAPPED is returned.

There must be a valid OpenGL context bound to the current thread when this function is called. This must be the same context, or a member of the same shareGroup, as the context that was bound when the buffer was registered.

Returns:
CUDA_SUCCESS, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_ALREADY_MAPPED, CUDA_ERROR_INVALID_CONTEXT,
See Also:
cuGraphicsResourceSetMapFlags(jcuda.driver.CUgraphicsResource, int)

cuGLMapBufferObjectAsync

public static int cuGLMapBufferObjectAsync(CUdeviceptr dptr,
                                           long[] size,
                                           int buffer,
                                           CUstream hStream)
Deprecated. This function is deprecated in the latest CUDA version

Maps an OpenGL buffer object.
CUresult cuGLMapBufferObjectAsync ( CUdeviceptr *  dptr,
size_t *  size,
GLuint  buffer,
CUstream  hStream  
)

Deprecated:
This function is deprecated as of Cuda 3.0.
Maps the buffer object specified by buffer into the address space of the current CUDA context and returns in *dptr and *size the base pointer and size of the resulting mapping.

There must be a valid OpenGL context bound to the current thread when this function is called. This must be the same context, or a member of the same shareGroup, as the context that was bound when the buffer was registered.

Stream hStream in the current CUDA context is synchronized with the current GL context.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_MAP_FAILED
See Also:
cuGraphicsMapResources(int, jcuda.driver.CUgraphicsResource[], jcuda.driver.CUstream)

cuGLUnmapBufferObjectAsync

public static int cuGLUnmapBufferObjectAsync(int buffer,
                                             CUstream hStream)
Deprecated. This function is deprecated in the latest CUDA version

Unmaps an OpenGL buffer object.
CUresult cuGLUnmapBufferObjectAsync ( GLuint  buffer,
CUstream  hStream  
)

Deprecated:
This function is deprecated as of Cuda 3.0.
Unmaps the buffer object specified by buffer for access by CUDA.

There must be a valid OpenGL context bound to the current thread when this function is called. This must be the same context, or a member of the same shareGroup, as the context that was bound when the buffer was registered.

Stream hStream in the current CUDA context is synchronized with the current GL context.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuGraphicsUnmapResources(int, jcuda.driver.CUgraphicsResource[], jcuda.driver.CUstream)

cuGraphicsUnregisterResource

public static int cuGraphicsUnregisterResource(CUgraphicsResource resource)
Unregisters a graphics resource for access by CUDA.
CUresult cuGraphicsUnregisterResource ( CUgraphicsResource  resource  ) 

Unregisters the graphics resource resource so it is not accessible by CUDA unless registered again.

If resource is invalid then CUDA_ERROR_INVALID_HANDLE is returned.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_UNKNOWN
See Also:
cuGraphicsGLRegisterBuffer(jcuda.driver.CUgraphicsResource, int, int), cuGraphicsGLRegisterImage(jcuda.driver.CUgraphicsResource, int, int, int)

cuGraphicsSubResourceGetMappedArray

public static int cuGraphicsSubResourceGetMappedArray(CUarray pArray,
                                                      CUgraphicsResource resource,
                                                      int arrayIndex,
                                                      int mipLevel)
Get an array through which to access a subresource of a mapped graphics resource.
CUresult cuGraphicsSubResourceGetMappedArray ( CUarray *  pArray,
CUgraphicsResource  resource,
unsigned int  arrayIndex,
unsigned int  mipLevel  
)

Returns in *pArray an array through which the subresource of the mapped graphics resource resource which corresponds to array index arrayIndex and mipmap level mipLevel may be accessed. The value set in *pArray may change every time that resource is mapped.

If resource is not a texture then it cannot be accessed via an array and CUDA_ERROR_NOT_MAPPED_AS_ARRAY is returned. If arrayIndex is not a valid array index for resource then CUDA_ERROR_INVALID_VALUE is returned. If mipLevel is not a valid mipmap level for resource then CUDA_ERROR_INVALID_VALUE is returned. If resource is not mapped then CUDA_ERROR_NOT_MAPPED is returned.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_MAPPED CUDA_ERROR_NOT_MAPPED_AS_ARRAY
See Also:
cuGraphicsResourceGetMappedPointer(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUgraphicsResource)

cuGraphicsResourceGetMappedMipmappedArray

public static int cuGraphicsResourceGetMappedMipmappedArray(CUmipmappedArray pMipmappedArray,
                                                            CUgraphicsResource resource)

cuGraphicsResourceGetMappedPointer

public static int cuGraphicsResourceGetMappedPointer(CUdeviceptr pDevPtr,
                                                     long[] pSize,
                                                     CUgraphicsResource resource)
Get a device pointer through which to access a mapped graphics resource.
CUresult cuGraphicsResourceGetMappedPointer ( CUdeviceptr *  pDevPtr,
size_t *  pSize,
CUgraphicsResource  resource  
)

Returns in *pDevPtr a pointer through which the mapped graphics resource resource may be accessed. Returns in pSize the size of the memory in bytes which may be accessed from that pointer. The value set in pPointer may change every time that resource is mapped.

If resource is not a buffer then it cannot be accessed via a pointer and CUDA_ERROR_NOT_MAPPED_AS_POINTER is returned. If resource is not mapped then CUDA_ERROR_NOT_MAPPED is returned. *

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_MAPPED CUDA_ERROR_NOT_MAPPED_AS_POINTER
See Also:
cuGraphicsMapResources(int, jcuda.driver.CUgraphicsResource[], jcuda.driver.CUstream), cuGraphicsSubResourceGetMappedArray(jcuda.driver.CUarray, jcuda.driver.CUgraphicsResource, int, int)

cuGraphicsResourceSetMapFlags

public static int cuGraphicsResourceSetMapFlags(CUgraphicsResource resource,
                                                int flags)
Set usage flags for mapping a graphics resource.
CUresult cuGraphicsResourceSetMapFlags ( CUgraphicsResource  resource,
unsigned int  flags  
)

Set flags for mapping the graphics resource resource.

Changes to flags will take effect the next time resource is mapped. The flags argument may be any of the following:

  • CU_GRAPHICS_MAP_RESOURCE_FLAGS_NONE: Specifies no hints about how this resource will be used. It is therefore assumed that this resource will be read from and written to by CUDA kernels. This is the default value.
  • CU_GRAPHICS_MAP_RESOURCE_FLAGS_READONLY: Specifies that CUDA kernels which access this resource will not write to this resource.
  • CU_GRAPHICS_MAP_RESOURCE_FLAGS_WRITEDISCARD: Specifies that CUDA kernels which access this resource will not read from this resource and will write over the entire contents of the resource, so none of the data previously stored in the resource will be preserved.

If resource is presently mapped for access by CUDA then CUDA_ERROR_ALREADY_MAPPED is returned. If flags is not one of the above values then CUDA_ERROR_INVALID_VALUE is returned.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_ALREADY_MAPPED
See Also:
cuGraphicsMapResources(int, jcuda.driver.CUgraphicsResource[], jcuda.driver.CUstream)

cuGraphicsMapResources

public static int cuGraphicsMapResources(int count,
                                         CUgraphicsResource[] resources,
                                         CUstream hStream)
Map graphics resources for access by CUDA.
CUresult cuGraphicsMapResources ( unsigned int  count,
CUgraphicsResource *  resources,
CUstream  hStream  
)

Maps the count graphics resources in resources for access by CUDA.

The resources in resources may be accessed by CUDA until they are unmapped. The graphics API from which resources were registered should not access any resources while they are mapped by CUDA. If an application does so, the results are undefined.

This function provides the synchronization guarantee that any graphics calls issued before cuGraphicsMapResources() will complete before any subsequent CUDA work issued in stream begins.

If resources includes any duplicate entries then CUDA_ERROR_INVALID_HANDLE is returned. If any of resources are presently mapped for access by CUDA then CUDA_ERROR_ALREADY_MAPPED is returned.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_ALREADY_MAPPED, CUDA_ERROR_UNKNOWN
See Also:
cuGraphicsResourceGetMappedPointer(jcuda.driver.CUdeviceptr, long[], jcuda.driver.CUgraphicsResource)

cuGraphicsUnmapResources

public static int cuGraphicsUnmapResources(int count,
                                           CUgraphicsResource[] resources,
                                           CUstream hStream)
Unmap graphics resources.
CUresult cuGraphicsUnmapResources ( unsigned int  count,
CUgraphicsResource *  resources,
CUstream  hStream  
)

Unmaps the count graphics resources in resources.

Once unmapped, the resources in resources may not be accessed by CUDA until they are mapped again.

This function provides the synchronization guarantee that any CUDA work issued in stream before cuGraphicsUnmapResources() will complete before any subsequently issued graphics work begins.

If resources includes any duplicate entries then CUDA_ERROR_INVALID_HANDLE is returned. If any of resources are not presently mapped for access by CUDA then CUDA_ERROR_NOT_MAPPED is returned.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_MAPPED, CUDA_ERROR_UNKNOWN
See Also:
cuGraphicsMapResources(int, jcuda.driver.CUgraphicsResource[], jcuda.driver.CUstream)

cuCtxSetLimit

public static int cuCtxSetLimit(int limit,
                                long value)
Set resource limits.
CUresult cuCtxSetLimit ( CUlimit  limit,
size_t  value  
)

Setting limit to value is a request by the application to update the current limit maintained by the context. The driver is free to modify the requested value to meet h/w requirements (this could be clamping to minimum or maximum values, rounding up to nearest element size, etc). The application can use cuCtxGetLimit() to find out exactly what the limit has been set to.

Setting each CUlimit has its own specific restrictions, so each is discussed here.

  • CU_LIMIT_STACK_SIZE controls the stack size of each GPU thread. This limit is only applicable to devices of compute capability 2.0 and higher. Attempting to set this limit on devices of compute capability less than 2.0 will result in the error CUDA_ERROR_UNSUPPORTED_LIMIT being returned.

  • CU_LIMIT_PRINTF_FIFO_SIZE controls the size of the FIFO used by the printf() device system call. Setting CU_LIMIT_PRINTF_FIFO_SIZE must be performed before launching any kernel that uses the printf() device system call, otherwise CUDA_ERROR_INVALID_VALUE will be returned. This limit is only applicable to devices of compute capability 2.0 and higher. Attempting to set this limit on devices of compute capability less than 2.0 will result in the error CUDA_ERROR_UNSUPPORTED_LIMIT being returned.

  • CU_LIMIT_MALLOC_HEAP_SIZE controls the size of the heap used by the malloc() and free() device system calls. Setting CU_LIMIT_MALLOC_HEAP_SIZE must be performed before launching any kernel that uses the malloc() or free() device system calls, otherwise CUDA_ERROR_INVALID_VALUE will be returned. This limit is only applicable to devices of compute capability 2.0 and higher. Attempting to set this limit on devices of compute capability less than 2.0 will result in the error CUDA_ERROR_UNSUPPORTED_LIMIT being returned.

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_UNSUPPORTED_LIMIT
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext), cuCtxGetApiVersion(jcuda.driver.CUcontext, int[]), cuCtxGetCacheConfig(int[]), cuCtxGetDevice(jcuda.driver.CUdevice), cuCtxGetLimit(long[], int), cuCtxPopCurrent(jcuda.driver.CUcontext), cuCtxPushCurrent(jcuda.driver.CUcontext), cuCtxSetCacheConfig(int), cuCtxSynchronize()

cuCtxGetCacheConfig

public static int cuCtxGetCacheConfig(int[] pconfig)
Returns the preferred cache configuration for the current context.
CUresult cuCtxGetCacheConfig ( CUfunc_cache *  pconfig  ) 

On devices where the L1 cache and shared memory use the same hardware resources, this returns through pconfig the preferred cache configuration for the current context. This is only a preference. The driver will use the requested configuration if possible, but it is free to choose a different configuration if required to execute functions.

This will return a pconfig of CU_FUNC_CACHE_PREFER_NONE on devices where the size of the L1 cache and shared memory are fixed.

The supported cache configurations are:

  • CU_FUNC_CACHE_PREFER_NONE: no preference for shared memory or L1 (default)
  • CU_FUNC_CACHE_PREFER_SHARED: prefer larger shared memory and smaller L1 cache
  • CU_FUNC_CACHE_PREFER_L1: prefer larger L1 cache and smaller shared memory
  • CU_FUNC_CACHE_PREFER_EQUAL: prefer equal sized L1 cache and shared memory

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext), cuCtxGetApiVersion(jcuda.driver.CUcontext, int[]), cuCtxGetDevice(jcuda.driver.CUdevice), cuCtxGetLimit(long[], int), cuCtxPopCurrent(jcuda.driver.CUcontext), cuCtxPushCurrent(jcuda.driver.CUcontext), cuCtxSetCacheConfig(int), cuCtxSetLimit(int, long), cuCtxSynchronize(), cuFuncSetCacheConfig(jcuda.driver.CUfunction, int)

cuCtxSetCacheConfig

public static int cuCtxSetCacheConfig(int config)
Sets the preferred cache configuration for the current context.
CUresult cuCtxSetCacheConfig ( CUfunc_cache  config  ) 

On devices where the L1 cache and shared memory use the same hardware resources, this sets through config the preferred cache configuration for the current context. This is only a preference. The driver will use the requested configuration if possible, but it is free to choose a different configuration if required to execute the function. Any function preference set via cuFuncSetCacheConfig() will be preferred over this context-wide setting. Setting the context-wide cache configuration to CU_FUNC_CACHE_PREFER_NONE will cause subsequent kernel launches to prefer to not change the cache configuration unless required to launch the kernel.

This setting does nothing on devices where the size of the L1 cache and shared memory are fixed.

Launching a kernel with a different preference than the most recent preference setting may insert a device-side synchronization point.

The supported cache configurations are:

  • CU_FUNC_CACHE_PREFER_NONE: no preference for shared memory or L1 (default)
  • CU_FUNC_CACHE_PREFER_SHARED: prefer larger shared memory and smaller L1 cache
  • CU_FUNC_CACHE_PREFER_L1: prefer larger L1 cache and smaller shared memory
  • CU_FUNC_CACHE_PREFER_EQUAL: prefer equal sized L1 cache and shared memory

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext), cuCtxGetApiVersion(jcuda.driver.CUcontext, int[]), cuCtxGetCacheConfig(int[]), cuCtxGetDevice(jcuda.driver.CUdevice), cuCtxGetLimit(long[], int), cuCtxPopCurrent(jcuda.driver.CUcontext), cuCtxPushCurrent(jcuda.driver.CUcontext), cuCtxSetLimit(int, long), cuCtxSynchronize(), cuFuncSetCacheConfig(jcuda.driver.CUfunction, int)

cuCtxGetSharedMemConfig

public static int cuCtxGetSharedMemConfig(int[] pConfig)
(Not available in CUDA 4.2) Returns the shared memory configuration

Parameters:
pConfig - The configuration
Returns:
The error return code
Throws:
java.lang.UnsupportedOperationException - Since this function is not available in CUDA 4.2

cuCtxSetSharedMemConfig

public static int cuCtxSetSharedMemConfig(int config)
(Not available in CUDA 4.2) Sets the shared memory configuration

Parameters:
config - The configuration
Returns:
The error return code
Throws:
java.lang.UnsupportedOperationException - Since this function is not available in CUDA 4.2

cuCtxGetApiVersion

public static int cuCtxGetApiVersion(CUcontext ctx,
                                     int[] version)
Gets the context's API version.
CUresult cuCtxGetApiVersion ( CUcontext  ctx,
unsigned int *  version  
)

Returns the API version used to create ctx in version. If ctx is NULL, returns the API version used to create the currently bound context.

This wil return the API version used to create a context (for example, 3010 or 3020), which library developers can use to direct callers to a specific API version. Note that this API version may not be the same as returned by cuDriverGetVersion.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_UNKNOWN
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext), cuCtxGetDevice(jcuda.driver.CUdevice), cuCtxGetLimit(long[], int), cuCtxPopCurrent(jcuda.driver.CUcontext), cuCtxPushCurrent(jcuda.driver.CUcontext), cuCtxSetCacheConfig(int), cuCtxSetLimit(int, long), cuCtxSynchronize()

cuLaunchKernel

public static int cuLaunchKernel(CUfunction f,
                                 int gridDimX,
                                 int gridDimY,
                                 int gridDimZ,
                                 int blockDimX,
                                 int blockDimY,
                                 int blockDimZ,
                                 int sharedMemBytes,
                                 CUstream hStream,
                                 Pointer kernelParams,
                                 Pointer extra)
Launches a CUDA function.
CUresult cuLaunchKernel ( CUfunction  f,
unsigned int  gridDimX,
unsigned int  gridDimY,
unsigned int  gridDimZ,
unsigned int  blockDimX,
unsigned int  blockDimY,
unsigned int  blockDimZ,
unsigned int  sharedMemBytes,
CUstream  hStream,
void **  kernelParams,
void **  extra  
)

Invokes the kernel f on a gridDimX x gridDimY x gridDimZ grid of blocks. Each block contains blockDimX x blockDimY x blockDimZ threads.

sharedMemBytes sets the amount of dynamic shared memory that will be available to each thread block.

cuLaunchKernel() can optionally be associated to a stream by passing a non-zero hStream argument.

Kernel parameters to f can be specified in one of two ways:

1) Kernel parameters can be specified via kernelParams. If f has N parameters, then kernelParams needs to be an array of N pointers. Each of kernelParams[0] through kernelParams[N-1] must point to a region of memory from which the actual kernel parameter will be copied. The number of kernel parameters and their offsets and sizes do not need to be specified as that information is retrieved directly from the kernel's image.

2) Kernel parameters can also be packaged by the application into a single buffer that is passed in via the extra parameter. This places the burden on the application of knowing each kernel parameter's size and alignment/padding within the buffer. Here is an example of using the extra parameter in this manner:

    size_t argBufferSize;
     char argBuffer[256];
 
     // populate argBuffer and argBufferSize
 
     void *config[] = {
         CU_LAUNCH_PARAM_BUFFER_POINTER, argBuffer,
         CU_LAUNCH_PARAM_BUFFER_SIZE,    &argBufferSize,
         CU_LAUNCH_PARAM_END
     };
     status = cuLaunchKernel(f, gx, gy, gz, bx, by, bz, sh, s, NULL,
 config);
 

The extra parameter exists to allow cuLaunchKernel to take additional less commonly used arguments. extra specifies a list of names of extra settings and their corresponding values. Each extra setting name is immediately followed by the corresponding value. The list must be terminated with either NULL or CU_LAUNCH_PARAM_END.

  • CU_LAUNCH_PARAM_END, which indicates the end of the extra array;
  • CU_LAUNCH_PARAM_BUFFER_POINTER, which specifies that the next value in extra will be a pointer to a buffer containing all the kernel parameters for launching kernel f;
  • CU_LAUNCH_PARAM_BUFFER_SIZE, which specifies that the next value in extra will be a pointer to a size_t containing the size of the buffer specified with CU_LAUNCH_PARAM_BUFFER_POINTER;

The error CUDA_ERROR_INVALID_VALUE will be returned if kernel parameters are specified with both kernelParams and extra (i.e. both kernelParams and extra are non-NULL).

Calling cuLaunchKernel() sets persistent function state that is the same as function state set through the following deprecated APIs:

cuFuncSetBlockShape() cuFuncSetSharedSize() cuParamSetSize() cuParamSeti() cuParamSetf() cuParamSetv()

When the kernel f is launched via cuLaunchKernel(), the previous block shape, shared size and parameter info associated with f is overwritten.

Note that to use cuLaunchKernel(), the kernel f must either have been compiled with toolchain version 3.2 or later so that it will contain kernel parameter information, or have no kernel parameters. If either of these conditions is not met, then cuLaunchKernel() will return CUDA_ERROR_INVALID_IMAGE.

Returns:
CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_INVALID_IMAGE, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_LAUNCH_FAILED, CUDA_ERROR_LAUNCH_OUT_OF_RESOURCES, CUDA_ERROR_LAUNCH_TIMEOUT, CUDA_ERROR_LAUNCH_INCOMPATIBLE_TEXTURING, CUDA_ERROR_SHARED_OBJECT_INIT_FAILED
See Also:
cuCtxGetCacheConfig(int[]), cuCtxSetCacheConfig(int), cuFuncSetCacheConfig(jcuda.driver.CUfunction, int), cuFuncGetAttribute(int[], int, jcuda.driver.CUfunction)

cuCtxGetLimit

public static int cuCtxGetLimit(long[] pvalue,
                                int limit)
Returns resource limits.
CUresult cuCtxGetLimit ( size_t *  pvalue,
CUlimit  limit  
)

Returns in *pvalue the current size of limit. The supported CUlimit values are:

  • CU_LIMIT_STACK_SIZE: stack size of each GPU thread;
  • CU_LIMIT_PRINTF_FIFO_SIZE: size of the FIFO used by the printf() device system call.
  • CU_LIMIT_MALLOC_HEAP_SIZE: size of the heap used by the malloc() and free() device system calls;

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_UNSUPPORTED_LIMIT
See Also:
cuCtxCreate(jcuda.driver.CUcontext, int, jcuda.driver.CUdevice), cuCtxDestroy(jcuda.driver.CUcontext), cuCtxGetApiVersion(jcuda.driver.CUcontext, int[]), cuCtxGetCacheConfig(int[]), cuCtxGetDevice(jcuda.driver.CUdevice), cuCtxPopCurrent(jcuda.driver.CUcontext), cuCtxPushCurrent(jcuda.driver.CUcontext), cuCtxSetCacheConfig(int), cuCtxSetLimit(int, long), cuCtxSynchronize()

cuProfilerInitialize

public static int cuProfilerInitialize(java.lang.String configFile,
                                       java.lang.String outputFile,
                                       int outputMode)
Initialize the profiling.
CUresult cuProfilerInitialize ( const char *  configFile,
const char *  outputFile,
CUoutput_mode  outputMode  
)

Using this API user can specify the configuration file, output file and output file format. This API is generally used to profile different set of counters/options by looping the kernel launch. configFile parameter can be used to select profiling options including profiler counters/options. Refer the "Command Line Profiler" section in the "Compute Visual Profiler User Guide" for supported profiler options and counters.

Configurations defined initially by environment variable settings are overwritten by cuProfilerInitialize().

Limitation: Profiling APIs do not work when the application is running with any profiler tool such as Compute Visual Profiler. User must handle error CUDA_ERROR_PROFILER_DISABLED returned by profiler APIs if application is likely to be used with any profiler tool.

Typical usage of the profiling APIs is as follows:

for each set of counters/options
{
cuProfilerInitialize(); //Initialize profiling, set the counters or options in the config file
...
cuProfilerStart();
// code to be profiled
cuProfilerStop();
...
cuProfilerStart();
// code to be profiled
cuProfilerStop();
...
}

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_PROFILER_DISABLED
See Also:
cuProfilerStart(), cuProfilerStop()

cuProfilerStart

public static int cuProfilerStart()
Start the profiling.
CUresult cuProfilerStart ( void   ) 

This API starts the profiling for a context if it is not started already. Profiling must be initalized using cuProfilerInitialize() before calling this API.

cuProfilerStart and cuProfilerStop APIs are used to programmatically control the profiling granularity by allowing profiling to be done only on selective pieces of code.

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_PROFILER_DISABLED, CUDA_ERROR_PROFILER_ALREADY_STARTED, CUDA_ERROR_PROFILER_NOT_INITIALIZED
See Also:
cuProfilerInitialize(java.lang.String, java.lang.String, int), cuProfilerStop()

cuProfilerStop

public static int cuProfilerStop()
Stop the profiling.
CUresult cuProfilerStop ( void   ) 

This API stops the profiling if it is not stopped already.

cuProfilerStart and cuProfilerStop APIs are used to programmatically control the profiling granularity by allowing profiling to be done only on selective pieces of code.

Returns:
CUDA_SUCCESS, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_PROFILER_DISABLED, CUDA_ERROR_PROFILER_ALREADY_STOPPED, CUDA_ERROR_PROFILER_NOT_INITIALIZED
See Also:
cuProfilerInitialize(java.lang.String, java.lang.String, int), cuProfilerStart()