public Class NVDeviceGeneratedCommandsCompute

Extends VkDescriptorSetLayoutCreateFlagBits.

Extends VkIndirectCommandsTokenTypeNV.

Enum values:

• INDIRECT_COMMANDS_TOKEN_TYPE_PIPELINE_NV
• INDIRECT_COMMANDS_TOKEN_TYPE_DISPATCH_NV

Extends VkIndirectCommandsTokenTypeNV.

Enum values:

• INDIRECT_COMMANDS_TOKEN_TYPE_PIPELINE_NV
• INDIRECT_COMMANDS_TOKEN_TYPE_DISPATCH_NV

The extension name.

The extension specification version.

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_DEVICE_GENERATED_COMMANDS_COMPUTE_FEATURES_NV
• STRUCTURE_TYPE_COMPUTE_PIPELINE_INDIRECT_BUFFER_INFO_NV
• STRUCTURE_TYPE_PIPELINE_INDIRECT_DEVICE_ADDRESS_INFO_NV

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_DEVICE_GENERATED_COMMANDS_COMPUTE_FEATURES_NV
• STRUCTURE_TYPE_COMPUTE_PIPELINE_INDIRECT_BUFFER_INFO_NV
• STRUCTURE_TYPE_PIPELINE_INDIRECT_DEVICE_ADDRESS_INFO_NV

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_DEVICE_GENERATED_COMMANDS_COMPUTE_FEATURES_NV
• STRUCTURE_TYPE_COMPUTE_PIPELINE_INDIRECT_BUFFER_INFO_NV
• STRUCTURE_TYPE_PIPELINE_INDIRECT_DEVICE_ADDRESS_INFO_NV

Unsafe version of: GetPipelineIndirectDeviceAddressNV

Unsafe version of: GetPipelineIndirectMemoryRequirementsNV

Update the indirect compute pipeline’s metadata.

C Specification

To save a compute pipeline’s metadata at a device address call:

void vkCmdUpdatePipelineIndirectBufferNV(
    VkCommandBuffer                             commandBuffer,
    VkPipelineBindPoint                         pipelineBindPoint,
    VkPipeline                                  pipeline);

Description

vkCmdUpdatePipelineIndirectBufferNV is only allowed outside of a render pass. This command is treated as a “transfer” operation for the purposes of synchronization barriers. The writes to the address must be synchronized using stages PIPELINE_STAGE_2_COPY_BIT and PIPELINE_STAGE_COMMAND_PREPROCESS_BIT_NV and with access masks ACCESS_MEMORY_WRITE_BIT and ACCESS_COMMAND_PREPROCESS_READ_BIT_NV respectively before using the results in preprocessing.

Valid Usage

• pipelineBindPoint must be PIPELINE_BIND_POINT_COMPUTE
• pipeline must have been created with PIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV flag set
• pipeline must have been created with VkComputePipelineIndirectBufferInfoNV structure specifying a valid address where its metadata will be saved
• The VkPhysicalDeviceDeviceGeneratedCommandsComputeFeaturesNV::deviceGeneratedComputePipelines feature must be enabled

Valid Usage (Implicit)

• commandBuffer must be a valid VkCommandBuffer handle
• pipelineBindPoint must be a valid VkPipelineBindPoint value
• pipeline must be a valid VkPipeline handle
• commandBuffer must be in the recording state
• The VkCommandPool that commandBuffer was allocated from must support transfer, graphics, or compute operations
• This command must only be called outside of a render pass instance
• This command must only be called outside of a video coding scope
• Both of commandBuffer, and pipeline must have been created, allocated, or retrieved from the same VkDevice

Host Synchronization

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

Command Properties

Parameters

commandBuffer:VkCommandBuffer

the command buffer into which the command will be recorded.

pipelineBindPoint:int

a VkPipelineBindPoint value specifying the type of pipeline whose metadata will be saved.

pipeline:long

the pipeline whose metadata will be saved.

Get pipeline’s 64-bit device address.

C Specification

To query a compute pipeline’s 64-bit device address, call:

VkDeviceAddress vkGetPipelineIndirectDeviceAddressNV(
    VkDevice                                    device,
    const VkPipelineIndirectDeviceAddressInfoNV* pInfo);

Valid Usage (Implicit)

• device must be a valid VkDevice handle
• pInfo must be a valid pointer to a valid VkPipelineIndirectDeviceAddressInfoNV structure

See Also

VkPipelineIndirectDeviceAddressInfoNV

Annotations

@NativeType:VkDeviceAddress

Get the memory requirements for the compute indirect pipeline.

C Specification

To determine the memory requirements for a compute pipeline’s metadata, call:

void vkGetPipelineIndirectMemoryRequirementsNV(
    VkDevice                                    device,
    const VkComputePipelineCreateInfo*          pCreateInfo,
    VkMemoryRequirements2*                      pMemoryRequirements);

Description

If pCreateInfo::pNext chain includes a pointer to a VkComputePipelineIndirectBufferInfoNV structure, then the contents of that structure are ignored.

Valid Usage

• The VkPhysicalDeviceDeviceGeneratedCommandsComputeFeaturesNV::deviceGeneratedComputePipelines feature must be enabled
• pCreateInfo::flags must include PIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV

Valid Usage (Implicit)

• device must be a valid VkDevice handle
• pCreateInfo must be a valid pointer to a valid VkComputePipelineCreateInfo structure
• pMemoryRequirements must be a valid pointer to a VkMemoryRequirements2 structure

See Also

VkComputePipelineCreateInfo, VkMemoryRequirements2

Parameters

device:VkDevice

the logical device that owns the buffer.

pCreateInfo:VkComputePipelineCreateInfo

a VkComputePipelineCreateInfo structure specifying the creation parameters of the compute pipeline whose memory requirements are being queried.

pMemoryRequirements:VkMemoryRequirements2

a pointer to a VkMemoryRequirements2 structure in which the requested pipeline’s memory requirements are returned.