C Specification

To specify additional attributes of NvSciSync handles exported from a semaphore, add a VkExportSemaphoreSciSyncInfoNV structure to the pNext chain of the VkSemaphoreCreateInfo structure. The VkExportSemaphoreSciSyncInfoNV structure is defined as:

// Provided by VK_NV_external_sci_sync
typedef struct VkExportSemaphoreSciSyncInfoNV {
    VkStructureType      sType;
    const void*          pNext;
    NvSciSyncAttrList    pAttributes;
} VkExportSemaphoreSciSyncInfoNV;

Members

  • sType is a VkStructureType value identifying this structure.

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

  • pAttributes is an opaque NvSciSyncAttrList describing the attributes of the NvSciSync object that will be exported.

Description

If VkExportSemaphoreCreateInfo is not present in the same pNext chain, this structure is ignored. If the pNext chain of VkSemaphoreCreateInfo includes a VkExportSemaphoreCreateInfo structure with a NvSciSync handleType, but either VkExportSemaphoreSciSyncInfoNV is not included in the pNext chain, or it is included but pAttributes is set to NULL, vkCreateSemaphore will return VK_ERROR_INITIALIZATION_FAILED.

The pAttributes must be a reconciled NvSciSyncAttrList. Before exporting a NvSciSync handle, the application must use the vkGetPhysicalDeviceSciSyncAttributesNV command to obtain the unreconciled NvSciSyncAttrList and then use the NvSciSync API to reconcile it.

Valid Usage
  • VUID-VkExportSemaphoreSciSyncInfoNV-pAttributes-05121
    pAttributes must be a reconciled NvSciSyncAttrList

Valid Usage (Implicit)
  • VUID-VkExportSemaphoreSciSyncInfoNV-sType-sType
    sType must be VK_STRUCTURE_TYPE_EXPORT_SEMAPHORE_SCI_SYNC_INFO_NV

See Also

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 2014-2023 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0