vkCreateCudaModuleNV - Creates a new CUDA module object

Description

Once a CUDA module has been created, you may create the function entry point that must refer to one function in the module.

Valid Usage (Implicit)

• device must be a valid Device handle

• pCreateInfo must be a valid pointer to a valid CudaModuleCreateInfoNV structure
• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
• pModule must be a valid pointer to a CudaModuleNV handle

Return Codes

Success

• SUCCESS

Failure

• ERROR_INITIALIZATION_FAILED
• ERROR_OUT_OF_HOST_MEMORY

See Also

VK_NV_cuda_kernel_launch, AllocationCallbacks, CudaModuleCreateInfoNV, CudaModuleNV, Device

A convenience wrapper to make a compatible pair of calls to createCudaModuleNV and destroyCudaModuleNV

To ensure that destroyCudaModuleNV is always called: pass bracket (or the allocate function from your favourite resource management library) as the last argument. To just extract the pair pass (,) as the last argument.

vkGetCudaModuleCacheNV - Get CUDA module cache

Valid Usage

• pCacheSize must be a pointer containing the amount of bytes to be copied in pCacheData. If pCacheData is NULL, the function will return in this pointer the total amount of bytes required to later perform the copy into pCacheData.

• pCacheData may be a pointer to a buffer in which the binary cache will be copied. The amount of bytes copied is defined by the value in pCacheSize. This pointer may be NULL. In this case, the function will write the total amount of required data in pCacheSize.

Valid Usage (Implicit)

• device must be a valid Device handle

• module must be a valid CudaModuleNV handle
• pCacheSize must be a valid pointer to a size_t value
• If the value referenced by pCacheSize is not 0, and pCacheData is not NULL, pCacheData must be a valid pointer to an array of pCacheSize bytes
• module must have been created, allocated, or retrieved from device

Return Codes

Success

• SUCCESS
• INCOMPLETE

Failure

• ERROR_INITIALIZATION_FAILED

See Also

VK_NV_cuda_kernel_launch, CudaModuleNV, Device

vkCreateCudaFunctionNV - Creates a new CUDA function object

Valid Usage (Implicit)

• device must be a valid Device handle

• pCreateInfo must be a valid pointer to a valid CudaFunctionCreateInfoNV structure
• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
• pFunction must be a valid pointer to a CudaFunctionNV handle

Return Codes

Success

• SUCCESS

Failure

• ERROR_INITIALIZATION_FAILED
• ERROR_OUT_OF_HOST_MEMORY

See Also

VK_NV_cuda_kernel_launch, AllocationCallbacks, CudaFunctionCreateInfoNV, CudaFunctionNV, Device

A convenience wrapper to make a compatible pair of calls to createCudaFunctionNV and destroyCudaFunctionNV

To ensure that destroyCudaFunctionNV is always called: pass bracket (or the allocate function from your favourite resource management library) as the last argument. To just extract the pair pass (,) as the last argument.

vkDestroyCudaModuleNV - Destroy a CUDA module

Valid Usage (Implicit)

• device must be a valid Device handle

• module must be a valid CudaModuleNV handle
• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
• module must have been created, allocated, or retrieved from device

See Also

VK_NV_cuda_kernel_launch, AllocationCallbacks, CudaModuleNV, Device

vkDestroyCudaFunctionNV - Destroy a CUDA function

Valid Usage (Implicit)

• device must be a valid Device handle

• function must be a valid CudaFunctionNV handle
• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
• function must have been created, allocated, or retrieved from device

See Also

VK_NV_cuda_kernel_launch, AllocationCallbacks, CudaFunctionNV, Device

vkCmdCudaLaunchKernelNV - Dispatch compute work items

Description

When the command is executed, a global workgroup consisting of gridDimX × gridDimY × gridDimZ local workgroups is assembled.

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pLaunchInfo must be a valid pointer to a valid CudaLaunchInfoNV structure
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics, or compute operations
• This command must only be called outside of a video coding scope

Host Synchronization

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

See Also

VK_NV_cuda_kernel_launch, CommandBuffer, CudaLaunchInfoNV

VkCudaModuleCreateInfoNV - Structure specifying the parameters to create a CUDA Module

Valid Usage (Implicit)

See Also

VK_NV_cuda_kernel_launch, StructureType, createCudaModuleNV

VkCudaFunctionCreateInfoNV - Structure specifying the parameters to create a CUDA Function

Valid Usage (Implicit)

See Also

VK_NV_cuda_kernel_launch, CudaModuleNV, StructureType, createCudaFunctionNV

VkCudaLaunchInfoNV - Structure specifying the parameters to launch a CUDA kernel

Valid Usage

• gridDimX must be less than or equal to PhysicalDeviceLimits::maxComputeWorkGroupCount[0]

• gridDimY must be less than or equal to PhysicalDeviceLimits::maxComputeWorkGroupCount[1]
• gridDimZ must be less than or equal to PhysicalDeviceLimits::maxComputeWorkGroupCount[2]
• paramCount must be the total amount of parameters listed in the pParams table.
• pParams must be a pointer to a table of paramCount parameters, corresponding to the arguments of function.
• extraCount must be 0
• pExtras must be NULL

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_CUDA_LAUNCH_INFO_NV

• pNext must be NULL
• function must be a valid CudaFunctionNV handle
• If paramCount is not 0, pParams must be a valid pointer to an array of paramCount bytes
• If extraCount is not 0, pExtras must be a valid pointer to an array of extraCount bytes

See Also

VK_NV_cuda_kernel_launch, CudaFunctionNV, StructureType, cmdCudaLaunchKernelNV

VkPhysicalDeviceCudaKernelLaunchFeaturesNV - Structure describing whether cuda kernel launch is supported by the implementation

Members

This structure describes the following features:

Description

If the PhysicalDeviceCudaKernelLaunchFeaturesNV structure is included in the pNext chain of the PhysicalDeviceFeatures2 structure passed to getPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. PhysicalDeviceCudaKernelLaunchFeaturesNV can also be used in the pNext chain of DeviceCreateInfo to selectively enable these features.

Valid Usage (Implicit)

See Also

VK_NV_cuda_kernel_launch, Bool32, StructureType

VkPhysicalDeviceCudaKernelLaunchPropertiesNV - Structure describing the compute capability version available

Members

The members of the PhysicalDeviceCudaKernelLaunchPropertiesNV structure describe the following features:

Description

If the PhysicalDeviceCudaKernelLaunchPropertiesNV structure is included in the pNext chain of the PhysicalDeviceProperties2 structure passed to getPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

Valid Usage (Implicit)

See Also

VK_NV_cuda_kernel_launch, StructureType

VkCudaModuleNV - Opaque handle to a CUDA module object

See Also

VK_NV_cuda_kernel_launch, CudaFunctionCreateInfoNV, createCudaModuleNV, destroyCudaModuleNV, getCudaModuleCacheNV

VkCudaFunctionNV - Opaque handle to a CUDA function object

See Also

VK_NV_cuda_kernel_launch, CudaLaunchInfoNV, createCudaFunctionNV, destroyCudaFunctionNV

VkDebugReportObjectTypeEXT - Specify the type of an object handle

Description

'

DebugReportObjectTypeEXT and Vulkan Handle Relationship

Note

The primary expected use of ERROR_VALIDATION_FAILED_EXT is for validation layer testing. It is not expected that an application would see this error code during normal use of the validation layers.

See Also

VK_EXT_debug_marker, VK_EXT_debug_report, DebugMarkerObjectNameInfoEXT, DebugMarkerObjectTagInfoEXT, debugReportMessageEXT