Structures

VkImportFenceWin32HandleInfoKHR

(None)

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;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • fence is the fence into which the state will be imported.
  • flags is a bitmask of VkFenceImportFlagBits specifying additional parameters for the fence payload import operation.
  • handleType is a VkExternalFenceHandleTypeFlagBits value specifying the type of handle.
  • handle is NULL or the external handle to import.
  • name is NULL or a null-terminated UTF-16 string naming the underlying synchronization primitive to import.

The handle types supported by handleType are:

Table 1. Handle Types Supported by VkImportFenceWin32HandleInfoKHR
Handle TypeTransferencePermanence Supported

VK_EXTERNAL_FENCE_HANDLE_TYPE_OPAQUE_WIN32_BIT

Reference

Temporary,Permanent

VK_EXTERNAL_FENCE_HANDLE_TYPE_OPAQUE_WIN32_KMT_BIT

Reference

Temporary,Permanent

Valid Usage

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

Host Synchronization

  • Host access to fence must be externally synchronized ::