// Copyright (c) 2014-2016 Khronos Group. This work is licensed under a
// Creative Commons Attribution 4.0 International License; see
// http://creativecommons.org/licenses/by/4.0/

vkCmdExecuteCommands(3)
=======================

Name
----
vkCmdExecuteCommands - Execute a secondary command buffer from a primary command buffer.

C Specification
---------------

// refBegin vkCmdExecuteCommands Execute a secondary command buffer from a primary command buffer.

A secondary command buffer mustnot: be directly submitted to a queue.
Instead, secondary command buffers are recorded to execute as part of a
primary command buffer with the command:

include::../protos/vkCmdExecuteCommands.txt[]


Parameters
----------

  * pname:commandBuffer is a handle to a primary command buffer that the
    secondary command buffers are submitted to, and must: be in the
    recording state.
  * pname:commandBufferCount is the length of the pname:pCommandBuffers
    array.
  * pname:pCommandBuffers is an array of secondary command buffer handles,
    which are recorded to execute in the primary command buffer in the order
    they are listed in the array.


Description
-----------

Once fname:vkCmdExecuteCommands has been called, any prior executions of the
secondary command buffers specified by pname:pCommandBuffers in any other
primary command buffer become invalidated, unless those secondary command
buffers were recorded with
ename:VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT.

include::../validity/protos/vkCmdExecuteCommands.txt[]


See Also
--------

slink:VkCommandBuffer


Document Notes
--------------

For more information, see the Vulkan Specification at URL

https://www.khronos.org/registry/vulkan/specs/1.0/xhtml/vkspec.html#vkCmdExecuteCommands

This page is extracted from the Vulkan Specification.
Fixes and changes should be made to the Specification,not directly.

include::footer.txt[]