Structure specifying Windows handle to import to a semaphore.

Description

The handle types supported by handleType are:

Handle Types Supported by VkImportSemaphoreWin32HandleInfoKHR

Handle Type	Transference	Permanence Supported
EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_BIT	Reference	Temporary,Permanent
EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_KMT_BIT	Reference	Temporary,Permanent
EXTERNAL_SEMAPHORE_HANDLE_TYPE_D3D12_FENCE_BIT	Reference	Temporary,Permanent

Valid Usage

• handleType must be a value included in the Handle Types Supported by VkImportSemaphoreWin32HandleInfoKHR table
• If handleType is not EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_BIT or EXTERNAL_SEMAPHORE_HANDLE_TYPE_D3D12_FENCE_BIT, name must be NULL
• If handle is NULL, name must name a valid synchronization primitive of the type specified by handleType
• If name is NULL, handle must be a valid handle of the type specified by handleType
• If handle is not NULL, name must be NULL
• If handle is not NULL, it must obey any requirements listed for handleType in external semaphore handle types compatibility
• If name is not NULL, it must obey any requirements listed for handleType in external semaphore handle types compatibility
• If handleType is EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_BIT or EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_KMT_BIT, the VkSemaphoreCreateInfo::flags field must match that of the semaphore from which handle or name was exported
• If handleType is EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_BIT or EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_KMT_BIT, the VkSemaphoreTypeCreateInfo::semaphoreType field must match that of the semaphore from which handle or name was exported
• If flags contains SEMAPHORE_IMPORT_TEMPORARY_BIT, the VkSemaphoreTypeCreateInfo::semaphoreType field of the semaphore from which handle or name was exported must not be SEMAPHORE_TYPE_TIMELINE

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_IMPORT_SEMAPHORE_WIN32_HANDLE_INFO_KHR
• pNext must be NULL
• semaphore must be a valid VkSemaphore handle
• flags must be a valid combination of VkSemaphoreImportFlagBits values

Host Synchronization

• Host access to semaphore must be externally synchronized

See Also

ImportSemaphoreWin32HandleKHR

Layout

struct VkImportSemaphoreWin32HandleInfoKHR {
    VkStructureType sType;
    void const * pNext;
    VkSemaphore semaphore;
    VkSemaphoreImportFlags flags;
    VkExternalSemaphoreHandleTypeFlagBits handleType;
    HANDLE handle;
    LPCWSTR name;
}