VkImportFenceWin32HandleInfoKHR
The VkImportFenceWin32HandleInfoKHR structure is defined as:
typedef struct VkImportFenceWin32HandleInfoKHR {
VkStructureType sType;
const void* pNext;
VkFence fence;
VkFenceImportFlags flags;
VkExternalFenceHandleTypeFlagBits handleType;
HANDLE handle;
LPCWSTR name;
} VkImportFenceWin32HandleInfoKHR;
sTypeis a VkStructureType value identifying this structure.pNextisNULLor a pointer to a structure extending this structure.fenceis the fence into which the state will be imported.flagsis a bitmask of VkFenceImportFlagBits specifying additional parameters for the fence payload import operation.handleTypeis a VkExternalFenceHandleTypeFlagBits value specifying the type ofhandle.handleisNULLor the external handle to import.nameisNULLor a null-terminated UTF-16 string naming the underlying synchronization primitive to import.
The handle types supported by handleType are:
| Handle Type | Transference | Permanence Supported |
|---|---|---|
Reference | Temporary,Permanent | |
Reference | Temporary,Permanent |
Valid Usage
VUID-VkImportFenceWin32HandleInfoKHR-handleType-01457
handleType must be a value included in the
Handle Types Supported by
VkImportFenceWin32HandleInfoKHR table
VUID-VkImportFenceWin32HandleInfoKHR-handleType-01459
If handleType is not
VK_EXTERNAL_FENCE_HANDLE_TYPE_OPAQUE_WIN32_BIT, name must
be NULL
VUID-VkImportFenceWin32HandleInfoKHR-handleType-01460
If handle is NULL, name must name a valid synchronization
primitive of the type specified by handleType
VUID-VkImportFenceWin32HandleInfoKHR-handleType-01461
If name is NULL, handle must be a valid handle of the
type specified by handleType
VUID-VkImportFenceWin32HandleInfoKHR-handle-01462
If handle is not NULL, name must be NULL
VUID-VkImportFenceWin32HandleInfoKHR-handle-01539
If handle is not NULL, it must obey any requirements listed for
handleType in external
fence handle types compatibility
VUID-VkImportFenceWin32HandleInfoKHR-name-01540
If name is not NULL, it must obey any requirements listed for
handleType in external
fence handle types compatibility
Valid Usage (Implicit)
VUID-VkImportFenceWin32HandleInfoKHR-sType-sType
sType must be VK_STRUCTURE_TYPE_IMPORT_FENCE_WIN32_HANDLE_INFO_KHR
VUID-VkImportFenceWin32HandleInfoKHR-pNext-pNext
pNext must be NULL
VUID-VkImportFenceWin32HandleInfoKHR-fence-parameter
fence must be a valid VkFence handle
VUID-VkImportFenceWin32HandleInfoKHR-flags-parameter
flags must be a valid combination of VkFenceImportFlagBits values
Host Synchronization
- Host access to
fencemust be externally synchronized ::