Vulkan-Docs/doc/specs/vulkan/man/vkCmdExecuteCommands.txt

67 lines
1.9 KiB
Plaintext

// 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::../api/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[]