Vulkan.Core10.Device

vkCreateDevice - Create a new device instance

Description

createDevice verifies that extensions and features requested in the ppEnabledExtensionNames and pEnabledFeatures members of pCreateInfo, respectively, are supported by the implementation. If any requested extension is not supported, createDevice must return ERROR_EXTENSION_NOT_PRESENT. If any requested feature is not supported, createDevice must return ERROR_FEATURE_NOT_PRESENT. Support for extensions can be checked before creating a device by querying enumerateDeviceExtensionProperties. Support for features can similarly be checked by querying getPhysicalDeviceFeatures.

After verifying and enabling the extensions the Device object is created and returned to the application.

Multiple logical devices can be created from the same physical device. Logical device creation may fail due to lack of device-specific resources (in addition to other errors). If that occurs, createDevice will return ERROR_TOO_MANY_OBJECTS.

Valid Usage

• All required device extensions for each extension in the DeviceCreateInfo::ppEnabledExtensionNames list must also be present in that list

Valid Usage (Implicit)

• physicalDevice must be a valid PhysicalDevice handle

• pCreateInfo must be a valid pointer to a valid DeviceCreateInfo structure

• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure

• pDevice must be a valid pointer to a Device handle

Return Codes

Success

• SUCCESS

Failure

• ERROR_DEVICE_LOST

• ERROR_EXTENSION_NOT_PRESENT

• ERROR_FEATURE_NOT_PRESENT

• ERROR_INITIALIZATION_FAILED

• ERROR_OUT_OF_DEVICE_MEMORY

• ERROR_OUT_OF_HOST_MEMORY

• ERROR_TOO_MANY_OBJECTS

• ERROR_UNKNOWN

• ERROR_VALIDATION_FAILED

See Also

VK_VERSION_1_0, AllocationCallbacks, Device, DeviceCreateInfo, PhysicalDevice

A convenience wrapper to make a compatible pair of calls to createDevice and destroyDevice

To ensure that destroyDevice is always called: pass bracket (or the allocate function from your favourite resource management library) as the last argument. To just extract the pair pass (,) as the last argument.

vkDestroyDevice - Destroy a logical device

Description

To ensure that no work is active on the device, deviceWaitIdle can be used to gate the destruction of the device. Prior to destroying a device, an application is responsible for destroying/freeing any Vulkan objects with explicit vkDestroy* or vkFree* commands that were created using that device as the first parameter of the corresponding vkCreate* or vkAllocate* command.

The lifetime of each of these objects is bound by the lifetime of the Device object. Therefore, to avoid resource leaks, it is critical that an application explicitly free all of these resources prior to calling destroyDevice.

Valid Usage

• All child objects created on device that can be destroyed or freed must have been destroyed or freed prior to destroying device

• If AllocationCallbacks were provided when device was created, a compatible set of callbacks must be provided here

• If no AllocationCallbacks were provided when device was created, pAllocator must be NULL

Valid Usage (Implicit)

• If device is not NULL, device must be a valid Device handle

• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure

Host Synchronization

• Host access to device must be externally synchronized

• Host access to all Queue objects created from device must be externally synchronized

See Also

VK_VERSION_1_0, AllocationCallbacks, Device

VkDeviceQueueCreateInfo - Structure specifying parameters of a newly created device queue

Description

Some queue families support functionality which requires a device feature or extension to be enabled, as indicated by the QueueFamilyProperties::queueFlags member. Applications may create such queues and submit queue submission commands to them without enabling the corresponding feature or extension, but must not utilize the specific functionality that they did not enable.

For example, sparse memory management operations can be performed on queues from queue families exposing the QUEUE_SPARSE_BINDING_BIT bit, provided the sparseBinding feature is enabled. If a queue family supports both the QUEUE_SPARSE_BINDING_BIT and QUEUE_TRANSFER_BIT bits, applications may create a queue from this family and issue transfer operations without enabling the sparseBinding feature.

Valid Usage

• queueFamilyIndex must be less than pQueueFamilyPropertyCount returned by getPhysicalDeviceQueueFamilyProperties

• queueCount must be less than or equal to the queueCount member of the QueueFamilyProperties structure, as returned by getPhysicalDeviceQueueFamilyProperties in the pQueueFamilyProperties[queueFamilyIndex]

• Each element of pQueuePriorities must be between 0.0 and 1.0 inclusive

• If the protectedMemory feature is not enabled, the DEVICE_QUEUE_CREATE_PROTECTED_BIT bit of flags must not be set

• If flags includes DEVICE_QUEUE_CREATE_PROTECTED_BIT, queueFamilyIndex must be the index of a queue family that includes the QUEUE_PROTECTED_BIT capability

• If the pNext chain includes a DeviceQueueShaderCoreControlCreateInfoARM structure then PhysicalDeviceSchedulingControlsPropertiesARM::schedulingControlsFlags must contain PHYSICAL_DEVICE_SCHEDULING_CONTROLS_SHADER_CORE_COUNT_ARM

• If the internallySynchronizedQueues feature is not enabled, flags must not include DEVICE_QUEUE_CREATE_INTERNALLY_SYNCHRONIZED_BIT_KHR

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_DEVICE_QUEUE_CREATE_INFO

• Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of DeviceQueueGlobalPriorityCreateInfo or DeviceQueueShaderCoreControlCreateInfoARM

• The sType value of each structure in the pNext chain must be unique

• flags must be a valid combination of DeviceQueueCreateFlagBits values

• pQueuePriorities must be a valid pointer to an array of queueCount float values

• queueCount must be greater than 0

See Also

VK_VERSION_1_0, DeviceCreateInfo, DeviceQueueCreateFlags, StructureType

VkDeviceCreateInfo - Structure specifying parameters of a newly created device

Valid Usage

• The combination of the values in the queueFamilyIndex and flags members of each element of pQueueCreateInfos must be unique within pQueueCreateInfos

• If multiple elements of pQueueCreateInfos share the same queueFamilyIndex, the sum of their queueCount members must be less than or equal to the queueCount member of the QueueFamilyProperties structure, as returned by getPhysicalDeviceQueueFamilyProperties in the pQueueFamilyProperties[queueFamilyIndex]

• If multiple elements of pQueueCreateInfos share the same queueFamilyIndex, then all of such elements must have the same global priority level, which can be specified explicitly by the including a DeviceQueueGlobalPriorityCreateInfo structure in the pNext chain, or by the implicit default value

• If the pNext chain includes a PhysicalDeviceFeatures2 structure, then pEnabledFeatures must be NULL

• If PhysicalDeviceProperties::apiVersion advertises Vulkan 1.1 or later, ppEnabledExtensionNames must not contain VK_AMD_negative_viewport_height

• ppEnabledExtensionNames must not contain both VK_KHR_maintenance1 and VK_AMD_negative_viewport_height

• ppEnabledExtensionNames must not contain both VK_KHR_buffer_device_address and VK_EXT_buffer_device_address

• If the pNext chain includes a PhysicalDeviceVulkan12Features structure and PhysicalDeviceVulkan12Features::bufferDeviceAddress is TRUE, ppEnabledExtensionNames must not contain VK_EXT_buffer_device_address

• If the pNext chain includes a PhysicalDeviceVulkan11Features structure, then it must not include a PhysicalDevice16BitStorageFeatures, PhysicalDeviceMultiviewFeatures, PhysicalDeviceVariablePointersFeatures, PhysicalDeviceProtectedMemoryFeatures, PhysicalDeviceSamplerYcbcrConversionFeatures, or PhysicalDeviceShaderDrawParametersFeatures structure

• If the pNext chain includes a PhysicalDeviceVulkan12Features structure, then it must not include a PhysicalDevice8BitStorageFeatures, PhysicalDeviceShaderAtomicInt64Features, PhysicalDeviceShaderFloat16Int8Features, PhysicalDeviceDescriptorIndexingFeatures, PhysicalDeviceScalarBlockLayoutFeatures, PhysicalDeviceImagelessFramebufferFeatures, PhysicalDeviceUniformBufferStandardLayoutFeatures, PhysicalDeviceShaderSubgroupExtendedTypesFeatures, PhysicalDeviceSeparateDepthStencilLayoutsFeatures, PhysicalDeviceHostQueryResetFeatures, PhysicalDeviceTimelineSemaphoreFeatures, PhysicalDeviceBufferDeviceAddressFeatures, or PhysicalDeviceVulkanMemoryModelFeatures structure

• If ppEnabledExtensionNames contains "VK_KHR_shader_draw_parameters" and the pNext chain includes a PhysicalDeviceVulkan11Features structure, then PhysicalDeviceVulkan11Features::shaderDrawParameters must be TRUE

• If ppEnabledExtensionNames contains "VK_KHR_draw_indirect_count" and the pNext chain includes a PhysicalDeviceVulkan12Features structure, then PhysicalDeviceVulkan12Features::drawIndirectCount must be TRUE

• If ppEnabledExtensionNames contains "VK_KHR_sampler_mirror_clamp_to_edge" and the pNext chain includes a PhysicalDeviceVulkan12Features structure, then PhysicalDeviceVulkan12Features::samplerMirrorClampToEdge must be TRUE

• If ppEnabledExtensionNames contains "VK_EXT_descriptor_indexing" and the pNext chain includes a PhysicalDeviceVulkan12Features structure, then PhysicalDeviceVulkan12Features::descriptorIndexing must be TRUE

• If ppEnabledExtensionNames contains "VK_EXT_sampler_filter_minmax" and the pNext chain includes a PhysicalDeviceVulkan12Features structure, then PhysicalDeviceVulkan12Features::samplerFilterMinmax must be TRUE

• If ppEnabledExtensionNames contains "VK_EXT_shader_viewport_index_layer" and the pNext chain includes a PhysicalDeviceVulkan12Features structure, then PhysicalDeviceVulkan12Features::shaderOutputViewportIndex and PhysicalDeviceVulkan12Features::shaderOutputLayer must both be TRUE

• If the pNext chain includes a PhysicalDeviceVulkan13Features structure, then it must not include a PhysicalDeviceDynamicRenderingFeatures, PhysicalDeviceImageRobustnessFeatures, PhysicalDeviceInlineUniformBlockFeatures, PhysicalDeviceMaintenance4Features, PhysicalDevicePipelineCreationCacheControlFeatures, PhysicalDevicePrivateDataFeatures, PhysicalDeviceShaderDemoteToHelperInvocationFeatures, PhysicalDeviceShaderIntegerDotProductFeatures, PhysicalDeviceShaderTerminateInvocationFeatures, PhysicalDeviceSubgroupSizeControlFeatures, PhysicalDeviceSynchronization2Features, PhysicalDeviceTextureCompressionASTCHDRFeatures, or PhysicalDeviceZeroInitializeWorkgroupMemoryFeatures structure

• If the pNext chain includes a PhysicalDeviceVulkan14Features structure, then it must not include a PhysicalDeviceGlobalPriorityQueryFeatures, PhysicalDeviceShaderSubgroupRotateFeatures, PhysicalDeviceShaderFloatControls2Features, PhysicalDeviceShaderExpectAssumeFeatures, PhysicalDeviceLineRasterizationFeatures, PhysicalDeviceVertexAttributeDivisorFeatures, PhysicalDeviceIndexTypeUint8Features, PhysicalDeviceDynamicRenderingLocalReadFeatures, PhysicalDeviceMaintenance5Features, PhysicalDeviceMaintenance6Features, PhysicalDevicePipelineProtectedAccessFeatures, PhysicalDevicePipelineRobustnessFeatures, or PhysicalDeviceHostImageCopyFeatures structure

• If ppEnabledExtensionNames contains "VK_KHR_push_descriptor" and the pNext chain includes a PhysicalDeviceVulkan14Features structure, then PhysicalDeviceVulkan14Features::pushDescriptor must be TRUE

• If the VK_KHR_portability_subset extension is included in pProperties of enumerateDeviceExtensionProperties, ppEnabledExtensionNames must include "VK_KHR_portability_subset"

• If the shadingRateImage feature is enabled, the pipelineFragmentShadingRate feature must not be enabled

• If the shadingRateImage feature is enabled, the primitiveFragmentShadingRate feature must not be enabled

• If the shadingRateImage feature is enabled, the attachmentFragmentShadingRate feature must not be enabled

• If the fragmentDensityMap feature is enabled, the pipelineFragmentShadingRate feature must not be enabled

• If the fragmentDensityMap feature is enabled, the primitiveFragmentShadingRate feature must not be enabled

• If the fragmentDensityMap feature is enabled, the attachmentFragmentShadingRate feature must not be enabled

• If the sparseImageInt64Atomics feature is enabled, shaderImageInt64Atomics must be enabled

• If the sparseImageFloat32Atomics feature is enabled, shaderImageFloat32Atomics must be enabled

• If the sparseImageFloat32AtomicAdd feature is enabled, shaderImageFloat32AtomicAdd must be enabled

• If the sparseImageFloat32AtomicMinMax feature is enabled, shaderImageFloat32AtomicMinMax must be enabled

• If the robustBufferAccess feature is enabled, and robustBufferAccessUpdateAfterBind is FALSE, then descriptorBindingUniformBufferUpdateAfterBind, descriptorBindingStorageBufferUpdateAfterBind, descriptorBindingUniformTexelBufferUpdateAfterBind, and descriptorBindingStorageTexelBufferUpdateAfterBind must not be enabled

• If the descriptorBuffer feature is enabled, ppEnabledExtensionNames must not contain VK_AMD_shader_fragment_mask

• If the pNext chain includes a DeviceQueueShaderCoreControlCreateInfoARM structure, then it must not be included in the pNext chain of any of the DeviceQueueCreateInfo structures in pQueueCreateInfos

• If the pNext chain includes a DeviceQueueShaderCoreControlCreateInfoARM structure then PhysicalDeviceSchedulingControlsPropertiesARM::schedulingControlsFlags must contain PHYSICAL_DEVICE_SCHEDULING_CONTROLS_SHADER_CORE_COUNT_ARM

• If the maintenance9 feature is not supported, queueCreateInfoCount must be greater than 0

• If any element of pQueueCreateInfos specifies a queueFamilyIndex that supports QUEUE_DATA_GRAPH_BIT_ARM and that queueFamilyIndex enumerates an engine through getPhysicalDeviceQueueFamilyDataGraphPropertiesARM with type PHYSICAL_DEVICE_DATA_GRAPH_PROCESSING_ENGINE_TYPE_NEURAL_QCOM or PHYSICAL_DEVICE_DATA_GRAPH_PROCESSING_ENGINE_TYPE_COMPUTE_QCOM, a PhysicalDeviceDataGraphModelFeaturesQCOM structure must be included in pNext with dataGraphModel set to TRUE

• enabledLayerCount must be 0

• ppEnabledLayerNames must be NULL

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_DEVICE_CREATE_INFO

• Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of DeviceDeviceMemoryReportCreateInfoEXT, DeviceDiagnosticsConfigCreateInfoNV, DeviceGroupDeviceCreateInfo, DeviceMemoryOverallocationCreateInfoAMD, DevicePipelineBinaryInternalCacheControlKHR, DevicePrivateDataCreateInfo, DeviceQueueShaderCoreControlCreateInfoARM, ExternalComputeQueueDeviceCreateInfoNV, PhysicalDevice16BitStorageFeatures, PhysicalDevice4444FormatsFeaturesEXT, PhysicalDevice8BitStorageFeatures, PhysicalDeviceASTCDecodeFeaturesEXT, PhysicalDeviceAccelerationStructureFeaturesKHR, PhysicalDeviceAddressBindingReportFeaturesEXT, PhysicalDeviceAmigoProfilingFeaturesSEC, PhysicalDeviceAntiLagFeaturesAMD, PhysicalDeviceAttachmentFeedbackLoopDynamicStateFeaturesEXT, PhysicalDeviceAttachmentFeedbackLoopLayoutFeaturesEXT, PhysicalDeviceBlendOperationAdvancedFeaturesEXT, PhysicalDeviceBorderColorSwizzleFeaturesEXT, PhysicalDeviceBufferDeviceAddressFeatures, PhysicalDeviceBufferDeviceAddressFeaturesEXT, VkPhysicalDeviceClusterAccelerationStructureFeaturesNV, PhysicalDeviceClusterCullingShaderFeaturesHUAWEI, PhysicalDeviceCoherentMemoryFeaturesAMD, PhysicalDeviceColorWriteEnableFeaturesEXT, PhysicalDeviceCommandBufferInheritanceFeaturesNV, PhysicalDeviceComputeOccupancyPriorityFeaturesNV, PhysicalDeviceComputeShaderDerivativesFeaturesKHR, PhysicalDeviceConditionalRenderingFeaturesEXT, PhysicalDeviceCooperativeMatrix2FeaturesNV, PhysicalDeviceCooperativeMatrixConversionFeaturesQCOM, PhysicalDeviceCooperativeMatrixFeaturesKHR, PhysicalDeviceCooperativeMatrixFeaturesNV, PhysicalDeviceCooperativeVectorFeaturesNV, PhysicalDeviceCopyMemoryIndirectFeaturesKHR, PhysicalDeviceCopyMemoryIndirectFeaturesNV, PhysicalDeviceCornerSampledImageFeaturesNV, PhysicalDeviceCoverageReductionModeFeaturesNV, PhysicalDeviceCubicClampFeaturesQCOM, PhysicalDeviceCubicWeightsFeaturesQCOM, PhysicalDeviceCudaKernelLaunchFeaturesNV, PhysicalDeviceCustomBorderColorFeaturesEXT, PhysicalDeviceCustomResolveFeaturesEXT, PhysicalDeviceDataGraphFeaturesARM, PhysicalDeviceDataGraphModelFeaturesQCOM, PhysicalDeviceDataGraphNeuralAcceleratorStatisticsFeaturesARM, PhysicalDeviceDataGraphOpticalFlowFeaturesARM, PhysicalDeviceDedicatedAllocationImageAliasingFeaturesNV, PhysicalDeviceDenseGeometryFormatFeaturesAMDX, PhysicalDeviceDepthBiasControlFeaturesEXT, PhysicalDeviceDepthClampControlFeaturesEXT, PhysicalDeviceDepthClampZeroOneFeaturesKHR, PhysicalDeviceDepthClipControlFeaturesEXT, PhysicalDeviceDepthClipEnableFeaturesEXT, PhysicalDeviceDescriptorBufferFeaturesEXT, PhysicalDeviceDescriptorBufferTensorFeaturesARM, PhysicalDeviceDescriptorHeapFeaturesEXT, PhysicalDeviceDescriptorIndexingFeatures, PhysicalDeviceDescriptorPoolOverallocationFeaturesNV, PhysicalDeviceDescriptorSetHostMappingFeaturesVALVE, PhysicalDeviceDeviceAddressCommandsFeaturesKHR, PhysicalDeviceDeviceGeneratedCommandsComputeFeaturesNV, PhysicalDeviceDeviceGeneratedCommandsFeaturesEXT, PhysicalDeviceDeviceGeneratedCommandsFeaturesNV, PhysicalDeviceDeviceMemoryReportFeaturesEXT, PhysicalDeviceDiagnosticsConfigFeaturesNV, PhysicalDeviceDisplacementMicromapFeaturesNV, PhysicalDeviceDynamicRenderingFeatures, PhysicalDeviceDynamicRenderingLocalReadFeatures, PhysicalDeviceDynamicRenderingUnusedAttachmentsFeaturesEXT, PhysicalDeviceElapsedTimerQueryFeaturesQCOM, PhysicalDeviceExclusiveScissorFeaturesNV, PhysicalDeviceExtendedDynamicState2FeaturesEXT, PhysicalDeviceExtendedDynamicState3FeaturesEXT, PhysicalDeviceExtendedDynamicStateFeaturesEXT, PhysicalDeviceExtendedSparseAddressSpaceFeaturesNV, PhysicalDeviceExternalFormatResolveFeaturesANDROID, PhysicalDeviceExternalMemoryRDMAFeaturesNV, PhysicalDeviceExternalMemoryScreenBufferFeaturesQNX, PhysicalDeviceFaultFeaturesEXT, PhysicalDeviceFaultFeaturesKHR, PhysicalDeviceFeatures2, PhysicalDeviceFormatPackFeaturesARM, PhysicalDeviceFragmentDensityMap2FeaturesEXT, PhysicalDeviceFragmentDensityMapFeaturesEXT, PhysicalDeviceFragmentDensityMapLayeredFeaturesVALVE, PhysicalDeviceFragmentDensityMapOffsetFeaturesEXT, PhysicalDeviceFragmentShaderBarycentricFeaturesKHR, PhysicalDeviceFragmentShaderInterlockFeaturesEXT, PhysicalDeviceFragmentShadingRateEnumsFeaturesNV, PhysicalDeviceFragmentShadingRateFeaturesKHR, PhysicalDeviceFrameBoundaryFeaturesEXT, PhysicalDeviceGlobalPriorityQueryFeatures, PhysicalDeviceGpaFeaturesAMD, PhysicalDeviceGraphicsPipelineLibraryFeaturesEXT, PhysicalDeviceHdrVividFeaturesHUAWEI, PhysicalDeviceHostImageCopyFeatures, PhysicalDeviceHostQueryResetFeatures, PhysicalDeviceImage2DViewOf3DFeaturesEXT, PhysicalDeviceImageAlignmentControlFeaturesMESA, PhysicalDeviceImageCompressionControlFeaturesEXT, PhysicalDeviceImageCompressionControlSwapchainFeaturesEXT, PhysicalDeviceImageProcessing2FeaturesQCOM, PhysicalDeviceImageProcessing3FeaturesQCOM, PhysicalDeviceImageProcessingFeaturesQCOM, PhysicalDeviceImageRobustnessFeatures, PhysicalDeviceImageSlicedViewOf3DFeaturesEXT, PhysicalDeviceImageViewMinLodFeaturesEXT, PhysicalDeviceImagelessFramebufferFeatures, PhysicalDeviceIndexTypeUint8Features, PhysicalDeviceInheritedViewportScissorFeaturesNV, PhysicalDeviceInlineUniformBlockFeatures, PhysicalDeviceInternallySynchronizedQueuesFeaturesKHR, PhysicalDeviceInvocationMaskFeaturesHUAWEI, PhysicalDeviceLegacyDitheringFeaturesEXT, PhysicalDeviceLegacyVertexAttributesFeaturesEXT, PhysicalDeviceLineRasterizationFeatures, PhysicalDeviceLinearColorAttachmentFeaturesNV, PhysicalDeviceMaintenance10FeaturesKHR, PhysicalDeviceMaintenance11FeaturesKHR, PhysicalDeviceMaintenance4Features, PhysicalDeviceMaintenance5Features, PhysicalDeviceMaintenance6Features, PhysicalDeviceMaintenance7FeaturesKHR, PhysicalDeviceMaintenance8FeaturesKHR, PhysicalDeviceMaintenance9FeaturesKHR, PhysicalDeviceMapMemoryPlacedFeaturesEXT, PhysicalDeviceMemoryDecompressionFeaturesEXT, PhysicalDeviceMemoryPriorityFeaturesEXT, PhysicalDeviceMeshShaderFeaturesEXT, PhysicalDeviceMeshShaderFeaturesNV, PhysicalDeviceMultiDrawFeaturesEXT, PhysicalDeviceMultisampledRenderToSingleSampledFeaturesEXT, PhysicalDeviceMultiviewFeatures, PhysicalDeviceMultiviewPerViewRenderAreasFeaturesQCOM, PhysicalDeviceMultiviewPerViewViewportsFeaturesQCOM, PhysicalDeviceMutableDescriptorTypeFeaturesEXT, PhysicalDeviceNestedCommandBufferFeaturesEXT, PhysicalDeviceNonSeamlessCubeMapFeaturesEXT, PhysicalDeviceOpacityMicromapFeaturesEXT, PhysicalDeviceOpacityMicromapFeaturesKHR, PhysicalDeviceOpticalFlowFeaturesNV, PhysicalDevicePageableDeviceLocalMemoryFeaturesEXT, VkPhysicalDevicePartitionedAccelerationStructureFeaturesNV, PhysicalDevicePerStageDescriptorSetFeaturesNV, VkPhysicalDevicePerformanceCountersByRegionFeaturesARM, PhysicalDevicePerformanceQueryFeaturesKHR, PhysicalDevicePipelineBinaryFeaturesKHR, PhysicalDevicePipelineCacheIncrementalModeFeaturesSEC, PhysicalDevicePipelineCreationCacheControlFeatures, PhysicalDevicePipelineExecutablePropertiesFeaturesKHR, PhysicalDevicePipelineLibraryGroupHandlesFeaturesEXT, PhysicalDevicePipelineOpacityMicromapFeaturesARM, PhysicalDevicePipelinePropertiesFeaturesEXT, PhysicalDevicePipelineProtectedAccessFeatures, PhysicalDevicePipelineRobustnessFeatures, PhysicalDevicePortabilitySubsetFeaturesKHR, PhysicalDevicePresentBarrierFeaturesNV, PhysicalDevicePresentId2FeaturesKHR, PhysicalDevicePresentIdFeaturesKHR, PhysicalDevicePresentMeteringFeaturesNV, PhysicalDevicePresentModeFifoLatestReadyFeaturesKHR, PhysicalDevicePresentTimingFeaturesEXT, PhysicalDevicePresentWait2FeaturesKHR, PhysicalDevicePresentWaitFeaturesKHR, PhysicalDevicePrimitiveRestartIndexFeaturesEXT, PhysicalDevicePrimitiveTopologyListRestartFeaturesEXT, PhysicalDevicePrimitivesGeneratedQueryFeaturesEXT, PhysicalDevicePrivateDataFeatures, PhysicalDeviceProtectedMemoryFeatures, PhysicalDeviceProvokingVertexFeaturesEXT, PhysicalDevicePushConstantBankFeaturesNV, PhysicalDeviceQueuePerfHintFeaturesQCOM, PhysicalDeviceRGBA10X6FormatsFeaturesEXT, PhysicalDeviceRasterizationOrderAttachmentAccessFeaturesEXT, PhysicalDeviceRawAccessChainsFeaturesNV, PhysicalDeviceRayQueryFeaturesKHR, PhysicalDeviceRayTracingInvocationReorderFeaturesEXT, PhysicalDeviceRayTracingInvocationReorderFeaturesNV, PhysicalDeviceRayTracingLinearSweptSpheresFeaturesNV, PhysicalDeviceRayTracingMaintenance1FeaturesKHR, PhysicalDeviceRayTracingMotionBlurFeaturesNV, PhysicalDeviceRayTracingPipelineFeaturesKHR, PhysicalDeviceRayTracingPositionFetchFeaturesKHR, PhysicalDeviceRayTracingValidationFeaturesNV, PhysicalDeviceRelaxedLineRasterizationFeaturesIMG, PhysicalDeviceRenderPassStripedFeaturesARM, PhysicalDeviceRepresentativeFragmentTestFeaturesNV, PhysicalDeviceRobustness2FeaturesKHR, PhysicalDeviceSamplerYcbcrConversionFeatures, PhysicalDeviceScalarBlockLayoutFeatures, PhysicalDeviceSchedulingControlsFeaturesARM, PhysicalDeviceSeparateDepthStencilLayoutsFeatures, PhysicalDeviceShader64BitIndexingFeaturesEXT, PhysicalDeviceShaderAbortFeaturesKHR, PhysicalDeviceShaderAtomicFloat16VectorFeaturesNV, PhysicalDeviceShaderAtomicFloat2FeaturesEXT, PhysicalDeviceShaderAtomicFloatFeaturesEXT, PhysicalDeviceShaderAtomicInt64Features, PhysicalDeviceShaderBfloat16FeaturesKHR, PhysicalDeviceShaderClockFeaturesKHR, PhysicalDeviceShaderConstantDataFeaturesKHR, PhysicalDeviceShaderCoreBuiltinsFeaturesARM, PhysicalDeviceShaderDemoteToHelperInvocationFeatures, PhysicalDeviceShaderDrawParametersFeatures, PhysicalDeviceShaderEarlyAndLateFragmentTestsFeaturesAMD, PhysicalDeviceShaderEnqueueFeaturesAMDX, PhysicalDeviceShaderExpectAssumeFeatures, PhysicalDeviceShaderFloat16Int8Features, PhysicalDeviceShaderFloat8FeaturesEXT, PhysicalDeviceShaderFloatControls2Features, PhysicalDeviceShaderFmaFeaturesKHR, PhysicalDeviceShaderImageAtomicInt64FeaturesEXT, PhysicalDeviceShaderImageFootprintFeaturesNV, PhysicalDeviceShaderInstrumentationFeaturesARM, PhysicalDeviceShaderIntegerDotProductFeatures, PhysicalDeviceShaderIntegerFunctions2FeaturesINTEL, PhysicalDeviceShaderLongVectorFeaturesEXT, PhysicalDeviceShaderMaximalReconvergenceFeaturesKHR, PhysicalDeviceShaderMixedFloatDotProductFeaturesVALVE, PhysicalDeviceShaderModuleIdentifierFeaturesEXT, PhysicalDeviceShaderMultipleWaitQueuesFeaturesQCOM, PhysicalDeviceShaderObjectFeaturesEXT, PhysicalDeviceShaderQuadControlFeaturesKHR, PhysicalDeviceShaderRelaxedExtendedInstructionFeaturesKHR, PhysicalDeviceShaderReplicatedCompositesFeaturesEXT, PhysicalDeviceShaderSMBuiltinsFeaturesNV, PhysicalDeviceShaderSplitBarrierFeaturesEXT, PhysicalDeviceShaderSubgroupExtendedTypesFeatures, PhysicalDeviceShaderSubgroupPartitionedFeaturesEXT, PhysicalDeviceShaderSubgroupRotateFeatures, PhysicalDeviceShaderSubgroupUniformControlFlowFeaturesKHR, PhysicalDeviceShaderTerminateInvocationFeatures, PhysicalDeviceShaderTileImageFeaturesEXT, PhysicalDeviceShaderUniformBufferUnsizedArrayFeaturesEXT, PhysicalDeviceShaderUntypedPointersFeaturesKHR, PhysicalDeviceShadingRateImageFeaturesNV, PhysicalDeviceSubgroupSizeControlFeatures, PhysicalDeviceSubpassMergeFeedbackFeaturesEXT, PhysicalDeviceSubpassShadingFeaturesHUAWEI, PhysicalDeviceSwapchainMaintenance1FeaturesKHR, PhysicalDeviceSynchronization2Features, PhysicalDeviceTensorFeaturesARM, PhysicalDeviceTexelBufferAlignmentFeaturesEXT, PhysicalDeviceTextureCompressionASTC3DFeaturesEXT, PhysicalDeviceTextureCompressionASTCHDRFeatures, PhysicalDeviceThrottleHintFeaturesSEC, PhysicalDeviceTileMemoryHeapFeaturesQCOM, PhysicalDeviceTilePropertiesFeaturesQCOM, PhysicalDeviceTileShadingFeaturesQCOM, PhysicalDeviceTimelineSemaphoreFeatures, PhysicalDeviceTransformFeedbackFeaturesEXT, PhysicalDeviceUnifiedImageLayoutsFeaturesKHR, PhysicalDeviceUniformBufferStandardLayoutFeatures, PhysicalDeviceVariablePointersFeatures, PhysicalDeviceVertexAttributeDivisorFeatures, PhysicalDeviceVertexAttributeRobustnessFeaturesEXT, PhysicalDeviceVertexInputDynamicStateFeaturesEXT, VkPhysicalDeviceVideoDecodeVP9FeaturesKHR, VkPhysicalDeviceVideoEncodeAV1FeaturesKHR, VkPhysicalDeviceVideoEncodeIntraRefreshFeaturesKHR, VkPhysicalDeviceVideoEncodeQuantizationMapFeaturesKHR, VkPhysicalDeviceVideoEncodeRgbConversionFeaturesVALVE, VkPhysicalDeviceVideoMaintenance1FeaturesKHR, VkPhysicalDeviceVideoMaintenance2FeaturesKHR, PhysicalDeviceVulkan11Features, PhysicalDeviceVulkan12Features, PhysicalDeviceVulkan13Features, PhysicalDeviceVulkan14Features, PhysicalDeviceVulkanMemoryModelFeatures, PhysicalDeviceWorkgroupMemoryExplicitLayoutFeaturesKHR, PhysicalDeviceYcbcr2Plane444FormatsFeaturesEXT, PhysicalDeviceYcbcrDegammaFeaturesQCOM, PhysicalDeviceYcbcrImageArraysFeaturesEXT, PhysicalDeviceZeroInitializeDeviceMemoryFeaturesEXT, or PhysicalDeviceZeroInitializeWorkgroupMemoryFeatures

• The sType value of each structure in the pNext chain must be unique, with the exception of structures of type DeviceDeviceMemoryReportCreateInfoEXT or DevicePrivateDataCreateInfo

• flags must be 0

• If queueCreateInfoCount is not 0, pQueueCreateInfos must be a valid pointer to an array of queueCreateInfoCount valid DeviceQueueCreateInfo structures

• If enabledExtensionCount is not 0, ppEnabledExtensionNames must be a valid pointer to an array of enabledExtensionCount null-terminated UTF-8 strings

• If pEnabledFeatures is not NULL, pEnabledFeatures must be a valid pointer to a valid PhysicalDeviceFeatures structure

See Also

VK_VERSION_1_0, DeviceCreateFlags, DeviceQueueCreateInfo, PhysicalDeviceFeatures, StructureType, createDevice

VkDevice - Opaque handle to a device object

See Also

VK_DEFINE_HANDLE, VK_VERSION_1_0, acquireFullScreenExclusiveModeEXT, acquireNextImage2KHR, acquireNextImageKHR, acquirePerformanceConfigurationINTEL, acquireProfilingLockKHR, allocateCommandBuffers, allocateDescriptorSets, allocateMemory, antiLagUpdateAMD, bindAccelerationStructureMemoryNV, bindBufferMemory, bindBufferMemory2, bindBufferMemory2, bindDataGraphPipelineSessionMemoryARM, bindImageMemory, bindImageMemory2, bindImageMemory2, bindOpticalFlowSessionImageNV, bindTensorMemoryARM, vkBindVideoSessionMemoryKHR, buildAccelerationStructuresKHR, buildMicromapsEXT, clearShaderInstrumentationMetricsARM, compileDeferredNV, convertCooperativeVectorMatrixNV, copyAccelerationStructureKHR, copyAccelerationStructureToMemoryKHR, copyImageToImage, copyImageToImage, copyImageToMemory, copyImageToMemory, copyMemoryToAccelerationStructureKHR, copyMemoryToImage, copyMemoryToImage, copyMemoryToMicromapEXT, copyMicromapEXT, copyMicromapToMemoryEXT, createAccelerationStructure2KHR, createAccelerationStructureKHR, createAccelerationStructureNV, createBuffer, createBufferCollectionFUCHSIA, createBufferView, createCommandPool, createComputePipelines, createCuFunctionNVX, createCuModuleNVX, createCudaFunctionNV, createCudaModuleNV, createDataGraphPipelineSessionARM, createDataGraphPipelinesARM, createDeferredOperationKHR, createDescriptorPool, createDescriptorSetLayout, createDescriptorUpdateTemplate, createDescriptorUpdateTemplate, createDevice, createEvent, createExecutionGraphPipelinesAMDX, createExternalComputeQueueNV, createFence, createFramebuffer, createGpaSessionAMD, createGraphicsPipelines, createImage, createImageView, createIndirectCommandsLayoutEXT, createIndirectCommandsLayoutNV, createIndirectExecutionSetEXT, createMicromapEXT, createOpticalFlowSessionNV, createPipelineBinariesKHR, createPipelineCache, createPipelineLayout, createPrivateDataSlot, createPrivateDataSlot, createQueryPool, createRayTracingPipelinesKHR, createRayTracingPipelinesNV, createRenderPass, createRenderPass2, createRenderPass2, createSampler, createSamplerYcbcrConversion, createSamplerYcbcrConversion, createSemaphore, createShaderInstrumentationARM, createShaderModule, createShadersEXT, createSharedSwapchainsKHR, createSwapchainKHR, createTensorARM, createTensorViewARM, createValidationCacheEXT, vkCreateVideoSessionKHR, vkCreateVideoSessionParametersKHR, debugMarkerSetObjectNameEXT, debugMarkerSetObjectTagEXT, deferredOperationJoinKHR, destroyAccelerationStructureKHR, destroyAccelerationStructureNV, destroyBuffer, destroyBufferCollectionFUCHSIA, destroyBufferView, destroyCommandPool, destroyCuFunctionNVX, destroyCuModuleNVX, destroyCudaFunctionNV, destroyCudaModuleNV, destroyDataGraphPipelineSessionARM, destroyDeferredOperationKHR, destroyDescriptorPool, destroyDescriptorSetLayout, destroyDescriptorUpdateTemplate, destroyDescriptorUpdateTemplate, destroyDevice, destroyEvent, destroyExternalComputeQueueNV, destroyFence, destroyFramebuffer, destroyGpaSessionAMD, destroyImage, destroyImageView, destroyIndirectCommandsLayoutEXT, destroyIndirectCommandsLayoutNV, destroyIndirectExecutionSetEXT, destroyMicromapEXT, destroyOpticalFlowSessionNV, destroyPipeline, destroyPipelineBinaryKHR, destroyPipelineCache, destroyPipelineLayout, destroyPrivateDataSlot, destroyPrivateDataSlot, destroyQueryPool, destroyRenderPass, destroySampler, destroySamplerYcbcrConversion, destroySamplerYcbcrConversion, destroySemaphore, destroyShaderEXT, destroyShaderInstrumentationARM, destroyShaderModule, destroySwapchainKHR, destroyTensorARM, destroyTensorViewARM, destroyValidationCacheEXT, vkDestroyVideoSessionKHR, vkDestroyVideoSessionParametersKHR, deviceWaitIdle, displayPowerControlEXT, exportMetalObjectsEXT, flushMappedMemoryRanges, freeCommandBuffers, freeDescriptorSets, freeMemory, getAccelerationStructureBuildSizesKHR, getAccelerationStructureDeviceAddressKHR, getAccelerationStructureHandleNV, getAccelerationStructureMemoryRequirementsNV, getAccelerationStructureOpaqueCaptureDescriptorDataEXT, getAndroidHardwareBufferPropertiesANDROID, getBufferCollectionPropertiesFUCHSIA, getBufferDeviceAddress, getBufferDeviceAddress, getBufferDeviceAddress, getBufferMemoryRequirements, getBufferMemoryRequirements2, getBufferMemoryRequirements2, getBufferOpaqueCaptureAddress, getBufferOpaqueCaptureAddress, getBufferOpaqueCaptureDescriptorDataEXT, getCalibratedTimestampsKHR, getCalibratedTimestampsKHR, vkGetClusterAccelerationStructureBuildSizesNV, getCudaModuleCacheNV, getDataGraphPipelineAvailablePropertiesARM, getDataGraphPipelinePropertiesARM, getDataGraphPipelineSessionBindPointRequirementsARM, getDataGraphPipelineSessionMemoryRequirementsARM, getDeferredOperationMaxConcurrencyKHR, getDeferredOperationResultKHR, getDescriptorEXT, getDescriptorSetHostMappingVALVE, getDescriptorSetLayoutBindingOffsetEXT, getDescriptorSetLayoutHostMappingInfoVALVE, getDescriptorSetLayoutSizeEXT, getDescriptorSetLayoutSupport, getDescriptorSetLayoutSupport, getDeviceAccelerationStructureCompatibilityKHR, getDeviceBufferMemoryRequirements, getDeviceBufferMemoryRequirements, getDeviceCombinedImageSamplerIndexNVX, getDeviceFaultDebugInfoKHR, getDeviceFaultInfoEXT, getDeviceFaultReportsKHR, getDeviceGroupPeerMemoryFeatures, getDeviceGroupPeerMemoryFeatures, getDeviceGroupPresentCapabilitiesKHR, getDeviceGroupSurfacePresentModes2EXT, getDeviceGroupSurfacePresentModesKHR, getDeviceImageMemoryRequirements, getDeviceImageMemoryRequirements, getDeviceImageSparseMemoryRequirements, getDeviceImageSparseMemoryRequirements, getDeviceImageSubresourceLayout, getDeviceImageSubresourceLayout, getDeviceMemoryCommitment, getDeviceMemoryOpaqueCaptureAddress, getDeviceMemoryOpaqueCaptureAddress, getDeviceMicromapCompatibilityEXT, getDeviceProcAddr, getDeviceQueue, getDeviceQueue2, getDeviceSubpassShadingMaxWorkgroupSizeHUAWEI, getDeviceTensorMemoryRequirementsARM, getDynamicRenderingTilePropertiesQCOM, vkGetEncodedVideoSessionParametersKHR, getEventStatus, getExecutionGraphPipelineNodeIndexAMDX, getExecutionGraphPipelineScratchSizeAMDX, getFenceFdKHR, getFenceStatus, getFenceWin32HandleKHR, getFramebufferTilePropertiesQCOM, getGeneratedCommandsMemoryRequirementsEXT, getGeneratedCommandsMemoryRequirementsNV, getGpaDeviceClockInfoAMD, getGpaSessionResultsAMD, getGpaSessionStatusAMD, getImageDrmFormatModifierPropertiesEXT, getImageMemoryRequirements, getImageMemoryRequirements2, getImageMemoryRequirements2, getImageOpaqueCaptureDataEXT, getImageOpaqueCaptureDescriptorDataEXT, getImageSparseMemoryRequirements, getImageSparseMemoryRequirements2, getImageSparseMemoryRequirements2, getImageSubresourceLayout, getImageSubresourceLayout2, getImageSubresourceLayout2, getImageSubresourceLayout2, getImageViewAddressNVX, getImageViewHandle64NVX, getImageViewHandleNVX, getImageViewOpaqueCaptureDescriptorDataEXT, getLatencyTimingsNV, getMemoryAndroidHardwareBufferANDROID, getMemoryFdKHR, getMemoryFdPropertiesKHR, getMemoryHostPointerPropertiesEXT, getMemoryMetalHandleEXT, getMemoryMetalHandlePropertiesEXT, vkGetMemoryNativeBufferOHOS, getMemoryRemoteAddressNV, getMemoryWin32HandleKHR, getMemoryWin32HandleNV, getMemoryWin32HandlePropertiesKHR, getMemoryZirconHandleFUCHSIA, getMemoryZirconHandlePropertiesFUCHSIA, getMicromapBuildSizesEXT, vkGetNativeBufferPropertiesOHOS, vkGetPartitionedAccelerationStructuresBuildSizesNV, getPastPresentationTimingEXT, getPastPresentationTimingGOOGLE, getPerformanceParameterINTEL, getPipelineBinaryDataKHR, getPipelineCacheData, getPipelineExecutableInternalRepresentationsKHR, getPipelineExecutablePropertiesKHR, getPipelineExecutableStatisticsKHR, getPipelineIndirectDeviceAddressNV, getPipelineIndirectMemoryRequirementsNV, getPipelineKeyKHR, getPipelinePropertiesEXT, getPrivateData, getPrivateData, getQueryPoolResults, getRayTracingCaptureReplayShaderGroupHandlesKHR, getRayTracingShaderGroupHandlesKHR, getRayTracingShaderGroupHandlesKHR, getRayTracingShaderGroupStackSizeKHR, getRefreshCycleDurationGOOGLE, getRenderAreaGranularity, getRenderingAreaGranularity, getRenderingAreaGranularity, getSamplerOpaqueCaptureDescriptorDataEXT, getScreenBufferPropertiesQNX, getSemaphoreCounterValue, getSemaphoreCounterValue, getSemaphoreFdKHR, getSemaphoreWin32HandleKHR, getSemaphoreZirconHandleFUCHSIA, getShaderBinaryDataEXT, getShaderInfoAMD, getShaderInstrumentationValuesARM, getShaderModuleCreateInfoIdentifierEXT, getShaderModuleIdentifierEXT, getSwapchainCounterEXT, getSwapchainImagesKHR, getSwapchainStatusKHR, getSwapchainTimeDomainPropertiesEXT, getSwapchainTimingPropertiesEXT, getTensorMemoryRequirementsARM, getTensorOpaqueCaptureDataARM, getTensorOpaqueCaptureDescriptorDataARM, getTensorViewOpaqueCaptureDescriptorDataARM, getValidationCacheDataEXT, vkGetVideoSessionMemoryRequirementsKHR, importFenceFdKHR, importFenceWin32HandleKHR, importSemaphoreFdKHR, importSemaphoreWin32HandleKHR, importSemaphoreZirconHandleFUCHSIA, initializePerformanceApiINTEL, invalidateMappedMemoryRanges, latencySleepNV, mapMemory, mapMemory2, mapMemory2, mergePipelineCaches, mergeValidationCachesEXT, registerCustomBorderColorEXT, registerDeviceEventEXT, registerDisplayEventEXT, releaseCapturedPipelineDataKHR, releaseFullScreenExclusiveModeEXT, releasePerformanceConfigurationINTEL, releaseProfilingLockKHR, releaseSwapchainImagesKHR, releaseSwapchainImagesKHR, resetCommandPool, resetDescriptorPool, resetEvent, resetFences, resetGpaSessionAMD, resetQueryPool, resetQueryPool, setBufferCollectionBufferConstraintsFUCHSIA, setBufferCollectionImageConstraintsFUCHSIA, setDebugUtilsObjectNameEXT, setDebugUtilsObjectTagEXT, setDeviceMemoryPriorityEXT, setEvent, setGpaDeviceClockModeAMD, setHdrMetadataEXT, setLatencyMarkerNV, setLatencySleepModeNV, setLocalDimmingAMD, setPrivateData, setPrivateData, setSwapchainPresentTimingQueueSizeEXT, signalSemaphore, signalSemaphore, transitionImageLayout, transitionImageLayout, trimCommandPool, trimCommandPool, uninitializePerformanceApiINTEL, unmapMemory, unmapMemory2, unmapMemory2, unregisterCustomBorderColorEXT, updateDescriptorSetWithTemplate, updateDescriptorSetWithTemplate, updateDescriptorSets, updateIndirectExecutionSetPipelineEXT, updateIndirectExecutionSetShaderEXT, vkUpdateVideoSessionParametersKHR, waitForFences, waitForPresent2KHR, waitForPresentKHR, waitSemaphores, waitSemaphores, writeAccelerationStructuresPropertiesKHR, writeMicromapsPropertiesEXT, writeResourceDescriptorsEXT, writeSamplerDescriptorsEXT

VkDeviceCreateFlags - Reserved for future use

Description

DeviceCreateFlags is a bitmask type for setting a mask, but is currently reserved for future use.

See Also

VK_VERSION_1_0, DeviceCreateInfo, Flags

VkDeviceQueueCreateFlagBits - Bitmask specifying behavior of the queue

Description

• DEVICE_QUEUE_CREATE_PROTECTED_BIT specifies that the device queue is a protected-capable queue.

• DEVICE_QUEUE_CREATE_INTERNALLY_SYNCHRONIZED_BIT_KHR specifies that the device queue is internally synchronized and does not require external synchronization.

See Also

VK_VERSION_1_1, DeviceQueueCreateFlags