C Specification

The VkImportSemaphoreSciSyncInfoNV structure is defined as:

// Provided by VK_NV_external_sci_sync
typedef struct VkImportSemaphoreSciSyncInfoNV {
    VkStructureType                          sType;
    const void*                              pNext;
    VkSemaphore                              semaphore;
    VkExternalSemaphoreHandleTypeFlagBits    handleType;
    void*                                    handle;
} VkImportSemaphoreSciSyncInfoNV;

Members

  • sType is a VkStructureType value identifying this structure.

  • pNext is NULL or a pointer to a structure extending this structure.

  • semaphore is the semaphore into which the payload will be imported.

  • handleType specifies the type of handle.

  • handle is the external handle to import.

Description

The handle types supported by handleType are:

Table 1. Handle Types Supported by VkImportSemaphoreSciSyncInfoNV
Handle Type Transference Permanence Supported

VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_SCI_SYNC_OBJ_BIT_NV

Reference

Permanent
Valid Usage

  • VUID-VkImportSemaphoreSciSyncInfoNV-handleType-05126
    handleType must be a value included in the Handle Types Supported by VkImportSemaphoreSciSyncInfoNV table

  • VUID-VkImportSemaphoreSciSyncInfoNV-semaphore-05127
    semaphore must have been created with a VkSemaphoreType of VK_SEMAPHORE_TYPE_TIMELINE

  • VUID-VkImportSemaphoreSciSyncInfoNV-semaphore-05128
    semaphore must not be associated with any queue command that has not yet completed execution on that queue

Valid Usage (Implicit)

  • VUID-VkImportSemaphoreSciSyncInfoNV-sType-sType
    sType must be VK_STRUCTURE_TYPE_IMPORT_SEMAPHORE_SCI_SYNC_INFO_NV

  • VUID-VkImportSemaphoreSciSyncInfoNV-pNext-pNext
    pNext must be NULL

  • VUID-VkImportSemaphoreSciSyncInfoNV-semaphore-parameter
    semaphore must be a valid VkSemaphore handle

  • VUID-VkImportSemaphoreSciSyncInfoNV-handleType-parameter
    handleType must be a valid VkExternalSemaphoreHandleTypeFlagBits value

  • VUID-VkImportSemaphoreSciSyncInfoNV-handle-parameter
    handle must be a pointer value

Host Synchronization

  • Host access to semaphore must be externally synchronized

See Also

VK_NV_external_sci_sync, VkExternalSemaphoreHandleTypeFlagBits, VkSemaphore, VkStructureType, vkImportSemaphoreSciSyncObjNV

Document Notes

For more information, see the Vulkan Specification

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

Copyright

Copyright 2014-2023 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0