vkBindVideoSessionMemoryKHR
To attach memory to a video session object, call:
VkResult vkBindVideoSessionMemoryKHR(
VkDevice device,
VkVideoSessionKHR videoSession,
uint32_t bindSessionMemoryInfoCount,
const VkBindVideoSessionMemoryInfoKHR* pBindSessionMemoryInfos);
device
is the logical device that owns the video session.videoSession
is the video session to be bound with device memory.bindSessionMemoryInfoCount
is the number of elements inpBindSessionMemoryInfos
.pBindSessionMemoryInfos
is a pointer to an array ofbindSessionMemoryInfoCount
VkBindVideoSessionMemoryInfoKHR 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
memoryBindIndex
member of the element ofpBindSessionMemoryInfos
in question matches thememoryBindIndex
member of one of the elements returned inpMemoryRequirements
when vkGetVideoSessionMemoryRequirementsKHR is called with the samevideoSession
and withpMemoryRequirementsCount
equal tobindSessionMemoryInfoCount
, then thememoryRequirements
member of that element ofpMemoryRequirements
is the VkMemoryRequirements structure corresponding to the element ofpBindSessionMemoryInfos
in question. - Otherwise the element of
pBindSessionMemoryInfos
in 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
videoSession
must be externally synchronized ::