Structures
VkDeviceGroupCommandBufferBeginInfo
Set the initial device mask for a command buffer
If the pNext
chain of VkCommandBufferBeginInfo includes a
VkDeviceGroupCommandBufferBeginInfo
structure, then that structure
includes an initial device mask for the command buffer.
The VkDeviceGroupCommandBufferBeginInfo
structure is defined as:
typedef struct VkDeviceGroupCommandBufferBeginInfo {
VkStructureType sType;
const void* pNext;
uint32_t deviceMask;
} VkDeviceGroupCommandBufferBeginInfo;
or the equivalent
typedef VkDeviceGroupCommandBufferBeginInfo VkDeviceGroupCommandBufferBeginInfoKHR;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.deviceMask
is the initial value of the command buffer’s device mask.
The initial device mask also acts as an upper bound on the set of devices that can ever be in the device mask in the command buffer.
If this structure is not present, the initial value of a command buffer’s device mask includes all physical devices in the logical device when the command buffer begins recording.
Valid Usage
VUID-VkDeviceGroupCommandBufferBeginInfo-deviceMask-00106
deviceMask
must be a valid device mask value
VUID-VkDeviceGroupCommandBufferBeginInfo-deviceMask-00107
deviceMask
must not be zero
Valid Usage (Implicit)
VUID-VkDeviceGroupCommandBufferBeginInfo-sType-sType
sType
must be VK_STRUCTURE_TYPE_DEVICE_GROUP_COMMAND_BUFFER_BEGIN_INFO