Skip to content

Comments

Clarify xrEnumerateInstanceExtensionProperties for API layers#490

Open
fredemmott wants to merge 1 commit intoKhronosGroup:mainfrom
fredemmott:xrEnumerateInstanceExtensionProperties
Open

Clarify xrEnumerateInstanceExtensionProperties for API layers#490
fredemmott wants to merge 1 commit intoKhronosGroup:mainfrom
fredemmott:xrEnumerateInstanceExtensionProperties

Conversation

@fredemmott
Copy link

Per https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#api-initialization , this function can be called before calling xrCreateInstance.

This function may: be called before an instance has been created; implementations must: not assume an instance exists.

Concretely, a bug in past versions of the Ultraleap API layer crashed if an instance had not been created.

Per https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#api-initialization , this function *can* be called before calling `xrCreateInstance`.

> This function may: be called before an instance has been created; implementations must: not assume an instance exists.

Concretely, a bug in past versions of the Ultraleap API layer crashed if an instance had not been created.
@fredemmott
Copy link
Author

Related docs PR: KhronosGroup/OpenXR-Docs#173

@rpavlik-bot
Copy link
Collaborator

An issue (number 2327) has been filed to correspond to this pull request in the internal Khronos GitLab (Khronos members only: KHR:openxr/openxr#2327 ), to facilitate working group processes.

This GitHub pull request will continue to be the main site of discussion.

@rblenkinsopp
Copy link

I think this is a good clarification. I'd be happy for this to be merged.

fredemmott added a commit to fredemmott/HTCC that referenced this pull request Nov 24, 2024
…them

If unavailable, should fail with XR_ERROR_EXTENSION_NOT_PRESENT, which can then be handled, and retried.

We can't actually reliably check if it's available by any other mechanism given the varied quality of implementations of xrEnumerateInstanceExtensionProperties, and the current spec wording - KhronosGroup/OpenXR-SDK-Source#490
@CLAassistant
Copy link

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

synced to gitlab Synchronized to OpenXR internal GitLab

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants