KhronosGroup / KhronosGroup/Vulkan-Docs

vkCreateInstance with extensions depending on Vulkan version

Open
#1,260 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
JavaScript
Stars
3.3k
Forks
549
Avg merge
5d 5h
Merged PRs (30d)
2

Description

Some extensions depend on Vulkan version, e.g. `VK_KHR_surface_protected_capabilities` depends on 1.1.

It is not clear how `vkCreateInstance` should behave.

Layers report this as `VUID-vkCreateInstance-ppEnabledExtensionNames-01388`:

> All required extensions for each extension in the `VkInstanceCreateInfo::ppEnabledExtensionNames` list **must** also be present in that list

But clearly this text only covers extension-extension dependency.

So that makes unclear if it is invalid usage, or should result in `VK_ERROR_EXTENSION_NOT_PRESENT`.

Contributor guide

Open the contributing guide

Research direction

Start by reading the vkCreateInstance requirements around VkInstanceCreateInfo::ppEnabledExtensionNames and VUID-vkCreateInstance-ppEnabledExtensionNames-01388, then compare them with the Vulkan-version dependency example in the issue. Done means the specification clearly states whether this case is invalid usage or returns VK_ERROR_EXTENSION_NOT_PRESENT.

Written by the indexing model from the issue text.

Assessment

Domain
api, computer-graphics, documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.