vkBindVideoSessionMemoryKHR
To attach memory to a video session object, call:
VkResult vkBindVideoSessionMemoryKHR(
VkDevice device,
VkVideoSessionKHR videoSession,
uint32_t bindSessionMemoryInfoCount,
const VkBindVideoSessionMemoryInfoKHR* pBindSessionMemoryInfos);
deviceis the logical device that owns the video session.videoSessionis the video session to be bound with device memory.bindSessionMemoryInfoCountis the number of elements inpBindSessionMemoryInfos.pBindSessionMemoryInfosis a pointer to an array ofbindSessionMemoryInfoCountVkBindVideoSessionMemoryInfoKHR structures specifying memory regions to be bound to specific memory bindings of the video session.
The valid usage statements below refer to the VkMemoryRequirements
structure corresponding to a specific element of
pBindSessionMemoryInfos, which is defined as follows:
- If the
memoryBindIndexmember of the element ofpBindSessionMemoryInfosin question matches thememoryBindIndexmember of one of the elements returned inpMemoryRequirementswhen vkGetVideoSessionMemoryRequirementsKHR is called with the samevideoSessionand withpMemoryRequirementsCountequal tobindSessionMemoryInfoCount, then thememoryRequirementsmember of that element ofpMemoryRequirementsis the VkMemoryRequirements structure corresponding to the element ofpBindSessionMemoryInfosin question. - Otherwise the element of
pBindSessionMemoryInfosin question is said to not have a corresponding VkMemoryRequirements structure.
Valid Usage
VUID-vkBindVideoSessionMemoryKHR-videoSession-07195
The memory binding of videoSession identified by the
memoryBindIndex member of any element of
pBindSessionMemoryInfos must not already be backed by a memory
object
VUID-vkBindVideoSessionMemoryKHR-memoryBindIndex-07196
The memoryBindIndex member of each element of
pBindSessionMemoryInfos must be unique within
pBindSessionMemoryInfos
VUID-vkBindVideoSessionMemoryKHR-pBindSessionMemoryInfos-07197
Each element of pBindSessionMemoryInfos must have a corresponding
VkMemoryRequirements structure
VUID-vkBindVideoSessionMemoryKHR-pBindSessionMemoryInfos-07198
If an element of pBindSessionMemoryInfos has a corresponding
VkMemoryRequirements structure, then the memory member of
that element of pBindSessionMemoryInfos must have been allocated
using one of the memory types allowed in the memoryTypeBits member
of the corresponding VkMemoryRequirements structure
VUID-vkBindVideoSessionMemoryKHR-pBindSessionMemoryInfos-07199
If an element of pBindSessionMemoryInfos has a corresponding
VkMemoryRequirements structure, then the memoryOffset member
of that element of pBindSessionMemoryInfos must be an integer
multiple of the alignment member of the corresponding
VkMemoryRequirements structure
VUID-vkBindVideoSessionMemoryKHR-pBindSessionMemoryInfos-07200
If an element of pBindSessionMemoryInfos has a corresponding
VkMemoryRequirements structure, then the memorySize member
of that element of pBindSessionMemoryInfos must equal the
size member of the corresponding VkMemoryRequirements
structure
Valid Usage (Implicit)
VUID-vkBindVideoSessionMemoryKHR-device-parameter
device must be a valid VkDevice handle
VUID-vkBindVideoSessionMemoryKHR-videoSession-parameter
videoSession must be a valid VkVideoSessionKHR handle
VUID-vkBindVideoSessionMemoryKHR-pBindSessionMemoryInfos-parameter
pBindSessionMemoryInfos must be a valid pointer to an array of bindSessionMemoryInfoCount valid VkBindVideoSessionMemoryInfoKHR structures
VUID-vkBindVideoSessionMemoryKHR-bindSessionMemoryInfoCount-arraylength
bindSessionMemoryInfoCount must be greater than 0
VUID-vkBindVideoSessionMemoryKHR-videoSession-parent
videoSession must have been created, allocated, or retrieved from device
Host Synchronization
- Host access to
videoSessionmust be externally synchronized ::